Agent Skillkit

Install stack-aware AI agent development skills for Claude Code and Codex.

@devmunna/agent-skillkit copies curated SKILL.md packages into a project, adds shared agent instructions, and keeps installed skills refreshable as the package evolves.

Quick Start

npx @devmunna/agent-skillkit init

The installer asks which agent to support:

• Claude Code: installs skills to .ai-skills/skills and updates CLAUDE.md
• Codex: installs skills to .agents/skills and writes shared AGENTS.md

Non-Interactive Use

npx @devmunna/agent-skillkit init --agent codex --profile express-prisma --yes
npx @devmunna/agent-skillkit init --agent claude --agent codex --stack react --stack tailwind --yes
npx @devmunna/agent-skillkit init --agent codex --skill node-base --skill zod-validation --yes

Commands

ai-skills init       # Install skills for a selected agent and stack
ai-skills add        # Add more skills to the configured agents
ai-skills list       # List installed or available skills
ai-skills update     # Refresh installed skills from the current package version
ai-skills validate   # Validate the package skill catalog and files
ai-skills doctor     # Inspect the current project installation

Profiles

Profiles install a tested combination of skills:

• express-prisma
• fastify-api
• next-fullstack
• react-spa
• mern
• node-base

Agent Behavior

The package is designed to reduce token usage and hallucination:

• Keep SKILL.md files focused on hard rules and activation context
• Put longer templates and examples in references/
• Generate AGENTS.md with rules for reading only relevant skills
• Install reusable workflows under .ai-skills/workflows
• Provide doctor and validate commands for drift checks

Development

Prerequisites:

• Node.js 18 or newer
• npm

Set up the project:

npm install
npm run typecheck
npm run build
npm test

Run the CLI locally while developing:

npm run dev -- init
npm run dev -- list
npm run dev -- doctor

Check what will be published:

npm pack --dry-run

The npm package only publishes the files listed in package.json:

• dist
• bin
• skills

Source files, tests, editor config, and local dependencies are not included in the published package.

Contributing

Contributions are welcome. Please keep changes focused and include validation steps in your pull request.

Recommended workflow:

1. Fork the repository.
2. Create a feature branch.
3. Install dependencies with npm install.
4. Make your changes.
5. Run npm run typecheck.
6. Run npm test.
7. Run npm pack --dry-run if your change affects published files.
8. Open a pull request with a short summary and test results.

Adding or Updating Skills

Skills live in skills/<skill-name>/SKILL.md. Larger examples, templates, or optional details should go in skills/<skill-name>/references/.

When adding a skill:

1. Create a clear SKILL.md with activation context and hard rules.
2. Move long examples into references/.
3. Register the skill in the package catalog if needed.
4. Add or update tests when behavior changes.
5. Run npm test.

Keep skill files concise so agents can load only the context they need.

Pull Request Checklist

• The package builds with npm run build.
• TypeScript passes with npm run typecheck.
• Tests pass with npm test.
• New skills include focused instructions and references only where useful.
• README or docs are updated when commands, profiles, or behavior change.

Release Checklist

Before publishing a new version:

npm test
npm pack --dry-run
npm publish --access public

Use npm pack --dry-run to confirm the package contents and size before release.

License

MIT