Sails Agent Skills

A CLI tool to help you discover, select, and install agent skills tailored to your project's requirements. Skills extend AI coding assistants (Copilot, Claude, Cursor) with domain-specific knowledge, company policies, and best practices.

Features

• Interactive questionnaire to identify your project's needs
• Smart skill recommendations based on tech stack, compliance requirements, and team preferences
• Seamless installation of skills into .agents/skills/ directory
• Support for both public and private skill packages
• Version locking with skills-lock.json
• Easy updates and management

Installation

npm install -g sails-agent-skills

Usage

Navigate to your project root and run:

sails-agent-skills

The CLI will:

1. Ask questions about your project (tech stack, compliance needs, etc.)
2. Recommend appropriate skills
3. Install selected skills into .agents/skills/
4. Create a skills-lock.json for reproducible setups

Commands

• sails-agent-skills - Interactive setup wizard
• sails-agent-skills --list - Show available skills in the catalog
• sails-agent-skills --customize - Customize installed skills
• sails-agent-skills --update - Check for and install updates
• sails-agent-skills --remove - Remove installed skills

How It Works

1. Answer Questions: The CLI asks about your project type, tech stack, compliance requirements (SOC2, GDPR, etc.), and team preferences.
2. Get Recommendations: Based on your answers, the CLI suggests relevant skills from the catalog.
3. Install Skills: Selected skills are installed via npm into .agents/skills/ where your AI agent will automatically discover them.
4. AI Assistant Enhancement: Your AI coding assistant now has specialized knowledge about your project's policies and standards.

Example Skills

• Security Standards: OWASP guidelines, secure coding practices, vulnerability scanning
• Coding Guidelines: Team conventions, code review standards, architecture patterns
• Compliance Workflows: Audit trails, approval processes, documentation requirements
• Testing Standards: Coverage requirements, E2E testing patterns, test-driven development

Publishing Skills

Skills are published as npm packages with a skills/ subdirectory containing one or more SKILL.md files. See the Skills Documentation for the SKILL.md format.

Multi-skill packages should be scoped (e.g., @sails-agent-skills/security-standards) and include:

package/
├── package.json
├── skills/
│   ├── skill-one/
│   │   └── SKILL.md
│   ├── skill-two/
│   │   └── SKILL.md
│   └── ...
└── README.md

Development

# Clone and setup
git clone <repository>
cd sails-agent-skills
npm install

# Build
npm run build

# Run locally
npm link
sails-agent-skills

# Watch mode
npm run dev

Project Structure

sails-agent-skills/
├── src/
│   ├── cli.ts              # Main CLI entry point
│   ├── questions/          # Interactive questionnaire definitions
│   ├── skills/             # Skill catalog and metadata
│   ├── installer/          # Installation logic
│   └── utils/              # Helper functions
├── skills/                 # Bundled skill packages (for development)
│   ├── coding-standards/
│   ├── security-standards/
│   └── ...
├── dist/                   # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

MIT