KillerSkills
Sign in
Documentation

Community Submissions

Anyone with a KillerSkills account can submit content to the marketplace by providing a URL to a properly formatted file. We fetch the content, validate it, check for duplicates, run a safety scan, and publish it automatically.

Supported Content Types

TypeFileFormat Guide
SkillSKILL.mdSKILL.md Format
PersonaPERSONA.mdPERSONA.md Format
PluginPLUGIN.mdPLUGIN.md Format
WorkflowWORKFLOW.mdWORKFLOW.md Format

How to Submit

  1. Go to the Submit page.
  2. Select the content type (Skill, Persona, Plugin, or Workflow). If your URL contains the filename (e.g. SKILL.md), the type is auto-detected.
  3. Paste the URL to your file. This can be a GitHub blob URL (e.g. https://github.com/user/repo/blob/main/SKILL.md) or a direct raw URL.
  4. Click Submit to Marketplace. You must be signed in.
  5. If the content passes validation and duplicate checks, it will be published immediately and you'll see a link to the marketplace page.

URL Requirements

  • The URL must be publicly accessible (no authentication required).
  • GitHub blob URLs are automatically converted to raw content URLs. For example: github.com/user/repo/blob/main/SKILL.md becomes raw.githubusercontent.com/user/repo/main/SKILL.md.
  • The file must be a text file (not binary) under 500KB.
  • The fetch has a 10-second timeout.

Duplicate Handling

We check for duplicates in two ways to prevent the same content from appearing multiple times:

URL match
If the same URL has already been submitted, you'll get a link to the existing item.
Content hash match
We compute a SHA-256 hash of the normalized content. If identical content was submitted from a different URL, you'll also get a link to the existing item.

Duplicate checks are global — they apply across all users, not just your own submissions.

Safety Scanning

Every submission is automatically scanned for security threats including:

  • Prompt injection and jailbreak attempts
  • Data exfiltration instructions
  • Social engineering tactics
  • Hidden or obfuscated instructions
  • Misleading content

Content is published immediately and scanned in the background. If threats are detected, the item is flagged for review. You can see safety badges on marketplace items.

Rate Limits

Community submissions are limited to 10 per day per IP address. This resets every 24 hours. If you hit the limit, you'll receive a 429 response.

Troubleshooting

“Failed to fetch URL”
The URL may not be publicly accessible, may have timed out, or may return a non-text content type. Make sure the file is public and the URL is correct.
“Validation failed”
The file content doesn't match the expected format. Check the format guide for your content type. Common issues: missing required frontmatter fields (name, description), empty body, or invalid YAML.
“Already exists”
The content or URL has already been submitted. You'll see a link to the existing item.
“Too many requests”
You've hit the daily rate limit of 10 submissions. Wait 24 hours and try again.

Next Steps