create-agent-skill

🚀 Create Agent Skills with one command for Cursor, Windsurf, Claude and more

✨ Features

• 📦 One Command Setup - Create a fully configured Agent Skill project instantly
• 🎯 Multiple Platforms - Support for Cursor, Windsurf, Claude, GitHub Copilot
• 📝 Interactive CLI - Guided prompts for easy configuration
• 🏗️ Best Practices - Generated projects follow established conventions
• 🔧 Customizable - Templates designed for easy modification

🚀 Quick Start

npx agentskill-create my-awesome-skill

That's it! The CLI will guide you through the setup process.

📖 Usage

Interactive Mode (Recommended)

npx agentskill-create my-skill-name

You'll be prompted for:

• Skill name - The name of your skill
• Description - Brief description of what your skill does
• Author - Your name or organization
• Platforms - Target AI assistants (Cursor, Windsurf, Claude, etc.)
• Category - Type of skill (Code Generation, Code Review, Testing, etc.)
• License - Open source license

Quick Mode

Skip prompts with default values:

npx agentskill-create my-skill-name --yes

Options

| Option | Description | |--------|-------------| | --yes, -y | Skip prompts and use defaults | | --no-git | Skip git initialization | | --template <name> | Use a specific template | | --version, -v | Show version number | | --help, -h | Show help |

📁 Generated Project Structure

my-awesome-skill/
├── SKILL.md              # Core skill configuration (YAML + Markdown)
├── README.md             # Project documentation
├── prompts/              # AI prompts directory
│   └── main.md           # Main skill prompt
├── examples/             # Usage examples (optional)
│   └── example.md        # Example interactions
├── .gitignore           
└── LICENSE               # Your chosen license

SKILL.md Format

The generated SKILL.md follows the standard Agent Skill format:

---
name: my-awesome-skill
description: A skill that helps with code review
author: John Doe
version: 1.0.0
category: code-review
platforms:
  - cursor
  - windsurf
  - claude
tags:
  - code-review
  - best-practices
---

# My Awesome Skill

## Description
Your skill description here...

## Usage
How to use this skill...

🎯 Supported Platforms

| Platform | Status | |----------|--------| | Cursor | ✅ Supported | | Windsurf | ✅ Supported | | Claude | ✅ Supported | | GitHub Copilot | ✅ Supported |

📂 Skill Categories

• 🔨 Code Generation - Generate code from descriptions
• 🔍 Code Review - Automated code review and suggestions
• 🧪 Testing - Generate and improve tests
• 📝 Documentation - Generate docs and comments
• ♻️ Refactoring - Code improvement suggestions
• 🐛 Debugging - Help identify and fix bugs
• 🏗️ Architecture - Design pattern guidance
• 🔒 Security - Security best practices
• ⚡ Performance - Performance optimization

📤 Publish Your Skill

Once you've created your skill, submit it to the Agent Skills Directory to reach thousands of AI coding enthusiasts:

👉 Submit to agentskills.help

Your skill will be discoverable by developers using Cursor, Windsurf, Claude, and more!

🤝 Contributing

We love contributions! Here's how you can help:

1. Report Bugs - Open an issue
2. Suggest Features - Start a discussion
3. Submit PRs - Fork, create a branch, and submit a pull request

Development

# Clone the repository
git clone https://github.com/qiao0919/create-agent-skill.git
cd create-agent-skill

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start -- my-test-skill

📄 License

MIT © agentskills.help

🌐 Discover More Skills

Browse hundreds of Agent Skills at agentskills.help - The Open Directory for AI Agent Skills.