agent-skills
Agent skills for coding workflow
agent-skills
Install standardized AI agent workflow skills and shared rules-file content into any repository with a single command.
Supports 40 AI coding agents including Claude Code, Cursor, Windsurf, Copilot, Cline, Roo Code, and more.
Languages: English | Tiếng Việt
What it does
Running the installer:
- Lets you select which agents to configure (auto-detects already-installed agents)
- Lets you choose whether the skills are installed as symlinks or copied files
- Installs workflow skills into each agent's skills directory via the Vercel skills CLI
- Injects shared agent instructions (
AGENTS.md) into each agent's rules file using idempotent markers
Installation
Interactive (recommended)
npx @buiducnhat/agent-skills@latest
Walks you through agent selection and install mode (symlink or copy).
Non-interactive (CI / automation)
npx @buiducnhat/agent-skills@latest --non-interactive
Skips all prompts and installs skills for all agents.
Via shell script
curl -fsSL https://raw.githubusercontent.com/buiducnhat/agent-skills/main/install.sh | bash
Checks for Node.js 18+ and runs the installer automatically.
Global install
npx @buiducnhat/agent-skills@latest --global
Installs skills to your home directory (~/<agent>/skills/) so they are available across all projects.
Interactive walkthrough
┌ Agent Skills Installer
│
◇ Select agents to install skills for:
│ ◼ Claude Code ◼ Cursor ◻ Windsurf ...
│
◇ How should the skills be installed?
│ ● Symlink (recommended) ○ Copy
│
◇ Installing skills via skills CLI...
│
◇ Installation complete!
│
│ What was set up:
│ CLAUDE.md - updated
│
│ Agent configurations updated for:
│ - claude-code
│ - cursor
│
└ Done! Your AI agent skills are ready.
CLI options
| Flag | Description |
|---|---|
--non-interactive |
Skip prompts; install all skills to all agents |
--copy |
Copy skill files instead of symlinking |
-g, --global |
Install to ~/ instead of the current directory |
-h, --help |
Show help |
-v, --version |
Show version |
Repository workflow skills
This repository currently defines eight first-party workflow skills, with four additional skills pinned in skills-lock.json (bootstrap, fix, review, and skill-creator from anthropics/skills):
| Skill | Description |
|---|---|
ask |
Ask clarifying questions to gather requirements and context |
as-fix |
Diagnose and resolve bugs with root-cause analysis and verification |
as-review |
Review uncommitted changes with codebase context and severity levels |
brainstorm |
Explore ideas and break down complex problems before planning |
docs |
Initialize (--init) or update (--update) project documentation |
execute-plan |
Execute written plans systematically with checkpoints |
quick-implement |
Rapid implementation for small, well-scoped changes |
write-plan |
Create detailed implementation plans with phases and tasks |
Recommended workflow sequences
Init documentations
/docs --init # or /docs --update for updating existing docs
Complex or ambiguous tasks
brainstorm → write-plan → execute-plan
Use when requirements are unclear or multiple approaches are possible.
# Step 1 — explore and define the design
/brainstorm add dark mode support
# Agent clarifies requirements, proposes approaches, writes:
# docs/brainstorms/260306-1430-dark-mode/SUMMARY.md
# Then prompts: "Proceed to write-plan?"
# Step 2 — create a phased implementation plan
/write-plan
# Agent reads the brainstorm, writes:
# docs/plans/260306-1445-dark-mode/SUMMARY.md
# docs/plans/260306-1445-dark-mode/phase-01-tokens.md
# docs/plans/260306-1445-dark-mode/phase-02-components.md
# Ends with: "Use /clear then /execute-plan docs/plans/... to execute"
# Step 3 — execute the approved plan in a fresh context
/clear
/execute-plan docs/plans/260306-1445-dark-mode/SUMMARY.md
Well-defined features or large refactors
write-plan → execute-plan
Use when the task is clear but too large or risky to implement without a plan.
# Step 1 — plan the work
/write-plan migrate auth to JWT
# Agent writes:
# docs/plans/260306-1020-jwt-auth/SUMMARY.md
# docs/plans/260306-1020-jwt-auth/phase-01-schema.md
# docs/plans/260306-1020-jwt-auth/phase-02-middleware.md
# Ends with: "Use /clear then /execute-plan docs/plans/... to execute"
# Step 2 — execute in a fresh context
/clear
/execute-plan docs/plans/260306-1020-jwt-auth/SUMMARY.md
Small tasks and quick fixes
quick-implement
Use for small, well-scoped changes where a formal plan would be overhead.
# Implement directly — no plan needed
/quick-implement add a tooltip to the submit button
Bug fixes
as-fix
Use when you have a concrete error, failing test, or unexpected behavior to diagnose.
/as-fix TypeError: Cannot read properties of undefined at checkout.ts:42
# For simple bugs: agent diagnoses, applies fix, verifies
# For complex bugs: agent stops and routes to write-plan
Supported agents
View all 40 supported agentsAdaL, Amp, Antigravity, Augment, Claude Code, Cline, CodeBuddy, Codex, Command Code, Continue, Cortex Code, Crush, Cursor, Droid, Gemini CLI, GitHub Copilot, Goose, iFlow CLI, Junie, Kilo Code, Kimi Code CLI, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, Neovate, OpenClaw, OpenCode, OpenHands, Pi, Pochi, Qoder, Qwen Code, Replit, Roo Code, Trae, Trae CN, Windsurf, Zencoder
Requirements
- Node.js 18+
gitavailable inPATH- Network access (to clone templates from GitHub)
Re-running the installer
Re-running is safe. Rules injection is idempotent — the existing content between markers is replaced without duplication. New agents can be added to an existing setup at any time.
Release
Tag pushes matching v* trigger the GitHub Actions workflow .github/workflows/release.yml to publish @buiducnhat/agent-skills to npm automatically.
Documentation
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found