Aiskillforge

Forge better code with AI skills.

Aiskillforge is an npm package that scaffolds a complete .agent toolkit for AI-assisted development across major IDEs.

Install

NPM package: https://www.npmjs.com/package/aiskillforge

npm install -g aiskillforge

Or run directly with npx:

npx aiskillforge init --ai claude

Usage

aiskillforge init --ai claude
aiskillforge init --ai cursor
aiskillforge init --ai windsurf
aiskillforge init --ai antigravity
aiskillforge init --ai copilot
aiskillforge init --ai kiro
aiskillforge init --ai codex

How to Use

1. Open your project folder in terminal.
2. Initialize Aiskillforge for your AI IDE:

aiskillforge init --ai claude

3. Open the same project in your IDE.
4. Check the generated .aiskillforge/ folder (placed inside the IDE's config folder — e.g. .github/.aiskillforge/ for Copilot, .cursor/.aiskillforge/ for Cursor):
   • agents/ for specialist personas
   • skills/ for domain knowledge modules
   • workflows/ for slash-command playbooks
5. Start with a workflow in your chat:
   • /brainstorm to explore options before implementation
   • /prd to draft a Product Requirements Document
   • /specify to write a structured feature spec with user stories
   • /clarify to reduce ambiguity in a spec before planning
   • /doc to create or update project documentation
   • /project-plan for task breakdown and technical planning
   • /tasks to generate a dependency-ordered task list
   • /analyze to audit consistency across spec, plan, and tasks
   • /checklist to validate requirement quality
   • /enhance to improve existing code safely
   • /create to build a feature from scratch
   • /implement to execute a plan phase by phase
   • /debug for root-cause troubleshooting
   • /test to generate and run tests
   • /full to run end-to-end planning and artifact generation in one flow
   • /pullrequest to assess PR risk, reviewers, and approval
   • /ui-ux-pro-max for design-first features

Example First Session

/brainstorm Compare JWT vs session auth for our app
/prd Create PRD for user authentication module
/specify Write feature spec for user registration and login
/clarify Clarify the registration spec requirements
/doc Update README with auth setup and API examples
/project-plan Build user authentication with email + password
/tasks Generate task list for the auth feature
/analyze Check spec, plan, and tasks for consistency
/checklist Validate auth feature spec quality
/enhance Improve existing login form validation
/create Implement login and signup pages
/implement Execute the auth implementation plan
/test auth service and API handlers
/debug login returns 401 on valid credentials
/full run complete planning flow and generate project artifacts
/pullrequest evaluate PR #42 for risk and reviewer assignment

The command creates:

• <ide-folder>/.aiskillforge/agents/
• <ide-folder>/.aiskillforge/skills/
• <ide-folder>/.aiskillforge/workflows/
• <ide-folder>/.aiskillforge/templates/
• <ide-folder>/.aiskillforge/rules/
• <ide-folder>/.aiskillforge/mcp_config.json
• IDE-specific configuration files based on --ai
• Workflow commands include /brainstorm, /prd, /specify, /clarify, /doc, /project-plan, /tasks, /analyze, /checklist, /enhance, /create, /implement, /debug, /test, /full, /pullrequest, /ui-ux-pro-max

Folder placement by IDE:

| IDE | Folder | |-----|--------| | GitHub Copilot | .github/.aiskillforge/ | | Cursor | .cursor/.aiskillforge/ | | Windsurf | .windsurf/.aiskillforge/ | | Claude | .claude/.aiskillforge/ | | Kiro, Codex, Antigravity | .aiskillforge/ |

Supported IDEs

• Claude
• Cursor
• Windsurf
• Antigravity
• GitHub Copilot
• Kiro
• Codex

Package Contents

• CLI source in bin/ and lib/
• Reusable scaffold templates in templates/.agent/
• Starter example in example-project/

Why It Is Useful In Development

• Creates a consistent AI workflow across teams and IDEs

• Reduces prompt drift by using reusable agents, skills, and slash-command workflows

• Speeds up feature delivery with a structured flow — from idea to running code:

  1. /specify — write a structured feature spec with user stories and acceptance criteria

     Example: "Specify user registration with email and password"

  2. /clarify — resolve ambiguities in the spec before any planning or code starts

     Example: "Clarify the registration spec — what happens on duplicate email?"

  3. /project-plan — break the feature into phases, milestones, and technical decisions

     Example: "Project-plan the auth module with JWT and refresh tokens"

  4. /tasks — generate a dependency-ordered, assignable task list from the plan

     Example: "Generate tasks for the auth feature plan"

  5. /implement — execute each plan phase step by step, with code and validation

     Example: "Implement phase 1 of the auth plan"

  Run /full to execute this entire flow in one command and generate all project artifacts automatically.

• Improves quality with built-in debugging, testing, review, and checklist workflows

• Works as project scaffolding so every new repo starts with the same AI operating model

License

MIT