Submit a Skill to SkillHub
Adding a new skill takes under 2 minutes. Open-source, content-as-data architecture via Pull Request.
If your repository already has a SKILL.md, our CLI tool reads its frontmatter and pre-populates the JSON manifest for you:
npm run add-skill -- https://github.com/your-username/your-skill-repo --category coding-devCreates content/skills/<slug>.json with all fields verified and ready for review.
Step-by-Step Submission Process
Fork & Clone the Repository
Fork the SkillHub repository on GitHub and clone it locally:
git clone https://github.com/your-username/skillhub.git cd skillhub npm install
Create Your Skill JSON Manifest
Create a file named content/skills/<your-skill-slug>.json:
{
"name": "My Great Skill",
"slug": "my-great-skill",
"short_description": "A concise description under 160 characters explaining what this skill does.",
"long_description": "Detailed markdown explanation of how to use this skill, example prompts, and features.",
"category": "coding-dev",
"tags": ["coding", "review", "productivity"],
"supported_agents": ["claude-code", "cursor", "gemini-cli"],
"author": "your-github-username",
"license": "MIT",
"version": "1.0.0",
"added_at": "2026-11-14",
"updated_at": "2026-11-14",
"github_url": "https://github.com/your-username/my-skill-repo",
"branch": "main",
"skill_path": "skills/my-great-skill",
"featured": false,
"verified": false,
"status": "active",
"requirements": ["Node 18+"]
}Run Automated Verification
Test your skill schema against our test suite:
npm run validateOpen a Pull Request
Commit your file and open a Pull Request. Continuous integration validates the build and merges automatically.
- Public repository accessible via HTTPS
- Valid SKILL.md file present
- Explicit open-source license (MIT, Apache-2.0, etc.)
- Zero hardcoded API secrets or unsafe terminal commands
- Category and supported agents exist in catalog definitions
Questions or Partnership Inquiries?
Read our full contribution guidelines or open a discussion on GitHub.