🤝 Contributing to Agent Skills

🤝 Contributing to Agent Skills

First of all, thank you for taking the time to contribute! 🎉

**Note**: This document provides all the necessary information to get your local environment set up, understand the architecture, create new skills, and safely submit your contributions.

🛠 Prerequisites

• Node.js ≥ 22
• npm (comes with Node.js)

🚀 Setup

git clone https://github.com/tech-leads-club/agent-skills.git
cd agent-skills
npm ci
npm run build

💻 Development Commands

Command	Description
npm run start:dev:cli	Run CLI locally (interactive mode)
npm run start:dev:mcp	Build MCP and open Inspector
npm run generate:skill	Generate a new skill
npm run validate	Validate all skills
npm run build	Build all packages
npm run test	Run all tests
npm run lint	Lint codebase
npm run format	Format code with Prettier
npm run scan	Run incremental security scan
nx run marketplace:dev	Run marketplace locally
nx run marketplace:generate-data	Update marketplace skills data

⭐ Creating a New Skill

**Important**: When creating a new skill or adding an external skill to the catalog, you **must** use the **`skill-architect`** skill to guide the process and ensure the skill follows our quality standards. If you're an AI agent, load the `skill-architect` skill before proceeding. If contributing manually, review the [Description Quality Standards](#description-quality-standards) below.

# With category (recommended)
nx g @tech-leads-club/skill-plugin:skill my-skill --category=development

# Full options
nx g @tech-leads-club/skill-plugin:skill my-skill \
  --description="What my skill does" \
  --category=development \
  --author="github.com/username" \
  --skillVersion="1.0.0"

The generator creates:

• packages/skills-catalog/skills/(development)/my-skill/SKILL.md

After generating the scaffold, refine the `SKILL.md` content (especially the `description` field) following the quality standards below.

📁 Project Structure

agent-skills/
├── packages/
│   ├── cli/                      # @tech-leads-club/agent-skills CLI
│   ├── marketplace/              # Next.js static site for the skill registry
│   └── skills-catalog/           # Skills collection
│       └── skills/               # All skill definitions
│           ├── (category-name)/  # Categorized skills
│           └── _category.json    # Category metadata
├── tools/
│   └── skill-plugin/             # Nx skill generator
├── skills-registry.json          # Auto-gene