🧠 Agent Skills

A curated collection of skills for AI coding agents

Extend the capabilities of Antigravity, Claude Code, Cursor, GitHub Copilot, and more with reusable, packaged instructions.

📖 Table of Contents

• ✨ What are Skills?
• 🤖 Supported Agents
• 🌟 Featured Skills
• 🚀 Quick Start
• ⚡ How It Works
• 🛠 For Contributors
• 📁 Project Structure
• 📝 Skill Structure
• 🔄 Release Process
• 🤝 Contributing
• 📄 License

✨ What are Skills?

Skills are packaged instructions and resources that extend AI agent capabilities. Think of them as plugins for your AI assistant — they teach your agent new workflows, patterns, and specialized knowledge.

packages/skills-catalog/skills/
  (category-name)/
    spec-driven-dev/
      SKILL.md          ← Main instructions
      templates/        ← File templates
      references/       ← On-demand documentation

🤖 Supported Agents

Install skills to any of these AI coding agents:

Tier 1 — Most Popular

Tier 2 — Rising Stars

Tier 3 — Enterprise & Specialized

_{Missing your favorite agent? Open an issue and we'll add support!}

🌟 Featured Skills

A glimpse of what's available in our growing catalog:

Skill	Category	Description
tlc-spec-driven	Development	Project and feature planning with 4 phases: Specify → Design → Tasks → Implement. Creates atomic tasks with verification criteria and maintains persistent memory across sessions.
aws-advisor	Cloud	Expert AWS Cloud Advisor for architecture design, security review, and implementation guidance. Leverages AWS MCP tools for documentation-backed answers.
playwright-skill	Automation	Complete browser automation with Playwright. Test pages, fill forms, take screenshots, validate UX, and automate any browser task.
figma	Design	Fetch design context from Figma and translate nodes into production code. Design-to-code implementation with MCP integration.
security-best-practices	Security	Language and framework-specific security reviews. Detect vulnerabilities, generate reports, and suggest secure-by-default fixes.

→ Browse all skills

---

🚀 Quick Start

Install Skills in Your Project

npx @tech-leads-club/agent-skills

This launches an interactive wizard:

1. Browse categories — Filter skills by category or select "All"
2. Select skills — Choose which skills to install
3. Choose agents — Pick target agents (Cursor, Claude Code, etc.)
4. Installation method — Symlink (recommended) or Copy
5. Scope — Global (user home) or Local (project only)

Each step shows a ← Back option to return and revise your choices.

CLI Options

# Interactive mode (default)
npx @tech-leads-club/agent-skills

# List available skills
npx @tech-leads-club/agent-skills list

# Install a specific skill
npx @tech-leads-club/agent-skills install -s spec-driven-dev

# Install to specific agents
npx @tech-leads-club/agent-skills install -a cursor claude-code

# Install globally (to ~/.gemini, ~/.claude, etc.)
npx @tech-leads-club/agent-skills install -g

# Force re-download (bypass cache)
npx @tech-leads-club/agent-skills install -s my-skill --force

# Update a specific skill
npx @tech-leads-club/agent-skills update -s my-skill

# Remove skills
npx @tech-leads-club/agent-skills remove

# Manage cache
npx @tech-leads-club/agent-skills cache --clear   # Clear all cache
npx @tech-leads-club/agent-skills cache --path    # Show cache location

# Show help
npx @tech-leads-club/agent-skills --help

Global Installation (Optional)

npm install -g @tech-leads-club/agent-skills
tlc-skills  # Use 'tlc-skills' instead of 'npx @tech-leads-club/agent-skills'

⚡ How It Works

The CLI fetches skills on-demand from our CDN:

1. Browse — The CLI fetches the skills catalog (~45KB)
2. Select — You choose the skills you need
3. Download — Selected skills are downloaded and cached locally
4. Install — Skills are installed to your agent's configuration

Caching

Downloaded skills are cached in ~/.cache/tlc-skills/ for offline use.

# Clear the cache
rm -rf ~/.cache/tlc-skills

🛠 For Contributors

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	Run CLI locally (interactive mode)
npm run g <name>	Generate a new skill
npm run build	Build all packages
npm run test	Run all tests
npm run lint	Lint codebase
npm run format	Format code with Prettier

Creating a New Skill

# 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

The generator creates:

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

📁 Project Structure

agent-skills/
├── packages/
│   ├── cli/                      # @tech-leads-club/agent-skills CLI
│   └── 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-generated catalog
├── .github/
│   └── workflows/                # CI/CD pipelines
└── nx.json                       # Nx configuration

📝 Skill Structure

packages/skills-catalog/skills/
├── (category-name)/              # Category folder
│   └── my-skill/                 # Skill folder
│       ├── SKILL.md              # Required: main instructions
│       ├── scripts/              # Optional: executable scripts
│       ├── templates/            # Optional: file templates
│       └── references/           # Optional: on-demand docs
└── _category.json                # Category metadata

SKILL.md Format

---
name: my-skill
description: What this skill does. Use when user says "trigger phrase".
---

# My Skill

Brief description.

## Process

1. Step one
2. Step two

Category Metadata

_category.json:

{
  "(development)": {
    "name": "Development",
    "description": "Skills for software development",
    "priority": 1
  }
}

Best Practices

• Keep SKILL.md under 500 lines — use references/ for detailed docs
• Write specific descriptions — include trigger phrases
• Assume the agent is smart — only add what it doesn't already know
• Prefer scripts over inline code — reduces context window usage

🔄 Release Process

This project uses Conventional Commits for automated versioning:

Commit Prefix	Version Bump	Example
feat:	Minor (0.X.0)	feat: add new skill
fix:	Patch (0.0.X)	fix: correct symlink path
feat!:	Major (X.0.0)	feat!: breaking API change
docs:	No bump	docs: update README
chore:	No bump	chore: update deps

Releases are automated via GitHub Actions when merging to main.

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-skill)
3. Commit with conventional commits (git commit -m "feat: add amazing skill")
4. Push to your fork (git push origin feat/amazing-skill)
5. Open a Pull Request

🛡️ Content & Authorship

This repository is a collection of curated skills intended to benefit the community. We deeply respect the intellectual property and wishes of all creators.

If you are the author of any content included here and would like it removed or updated, please open an issue or contact the maintainers.

📄 License

MIT © Tech Leads Club

⭐ Star History

---

_{Built with ❤️ by the Tech Leads Club community}