@nolrm/contextkit 0.13.7 → 0.14.1

package/README.md

@@ -114,7 +114,7 @@ Each platform generates bridge files that the AI tool auto-reads. If a bridge fi
 /fix        # diagnose and fix bugs
 ```
 
-**Claude Code** — `CLAUDE.md` uses `@` imports to auto-load all standards into context every session (no manual reads needed, saves tokens). Slash commands in `.claude/commands/`.
+**Claude Code** — `CLAUDE.md` uses `@` imports to auto-load all standards into context every session (no manual reads needed, saves tokens). Skills in `.claude/skills/`.
 
 ```bash
 /analyze    # scan codebase and generate standards
@@ -165,10 +165,13 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/squad-review`        | Review the full pipeline and give a verdict                                                                                     |
 | `/squad-doc`           | Create companion `.md` files for new/modified code after review passes                                                          |
 | `/squad-auto`          | Auto-run the full pipeline after kickoff (recommended, sequential)                                                              |
-| `/squad-auto-parallel` | Auto-run the pipeline in parallel using Claude Code agents (Claude Code only)                                                   |
-| `/ck`                  | Health check — verify setup, standards, and integrations                                                                        |
+| `/squad-auto-parallel`    | Auto-run the pipeline in parallel using Claude Code agents (Claude Code only)                                                   |
+| `/ck`                     | Health check — verify setup, standards, and integrations                                                                        |
+| `/agent-push-checklist`   | Pre-push quality checklist for agents to self-check before `git push`                                                           |
+| `/context-budget`         | Prioritized guide for which standards files to load for a given task                                                            |
+| `/standards-aware`        | Decide whether and how to add a newly discovered pattern to the project's standards files                                       |
 
-**Claude Code** — available as `/analyze`, `/review`, etc. in `.claude/commands/`
+**Claude Code** — available as `/analyze`, `/review`, etc. via `.claude/skills/`
 **Cursor** — available as slash commands in Chat via `.cursor/prompts/`
 
 Both platforms delegate to the universal command files in `.contextkit/commands/`, so you maintain one set of workflows.
@@ -283,6 +286,18 @@ The pre-push hook detects your project type and runs the right quality checks au
 | **Swift**     | SwiftLint, swift test                                                                                                                                                                  |
 | **.NET / C#** | dotnet build, dotnet test                                                                                                                                                              |
 
+### Managing Gates
+
+Use `ck gates` to inspect or toggle individual checks without editing config files manually:
+
+```bash
+ck gates                        # list all gates and their status
+ck gates --disable prettier     # disable a specific gate
+ck gates --enable prettier      # re-enable it
+```
+
+Gate state is saved to `.contextkit/quality-gates.yml`. Commit this file to share gate preferences with your team.
+
 ### Commit Message Format
 
 When the `commit-msg` hook is enabled, all commits must follow this format:

package/lib/commands/install.js

@@ -133,6 +133,9 @@ class InstallCommand {
       await this.installGitHubActionsWorkflow();
     }
 
+    // Create quality gates config
+    await this.createQualityGatesConfig();
+
     // Create configuration
     await this.createConfiguration(projectType, hookChoices, squadCi);
 
@@ -496,11 +499,43 @@ Run \`/analyze\` to generate this content.`,
 
       'standards/ai-guidelines.md': `# AI Guidelines
 
-<!-- Content will be generated by running: /analyze -->
+> Run \`/analyze\` to add project-specific rules to this file.
 
-Guidelines for AI assistance will be defined based on your project's needs and patterns.
+## Agentic Workflow
 
-Run \`/analyze\` to generate this content.`,
+When working as an agent in this project:
+
+- **Read standards first** — load \`code-style.md\` and \`testing.md\` before writing code
+- **Before pushing** — run through \`.contextkit/commands/agents/agent-push-checklist.md\`
+- **Commit format** — all commits must follow Conventional Commits: \`type(scope): description\`
+  - Valid types: \`feat\`, \`fix\`, \`improve\`, \`docs\`, \`chore\`, \`refactor\`, \`test\`
+- **When to proceed** — proceed if the task is clear and standards cover it
+- **When to ask** — ask if the task is ambiguous, contradicts existing standards, or requires an architecture decision
+- **No debug statements** — do not leave \`console.log\`, \`print\`, or equivalent debug output in production code
+
+## Context Budget
+
+Load standards files in this priority order to use your context window efficiently:
+
+1. **Always load:** \`code-style.md\`, \`testing.md\` — highest signal, always relevant
+2. **Load at session start:** \`ai-guidelines.md\` (this file) — behaviour rules
+3. **Load on demand:** \`architecture.md\` — only when making structural decisions
+4. **Load on demand:** \`workflows.md\` — only for process questions
+5. **Load selectively:** \`code-style/typescript-style.md\`, \`code-style/css-style.md\` — only for the file type you are editing
+6. **Skip unless needed:** \`glossary.md\` — only when the task involves domain-specific terms
+
+If a standards file is longer than 200 lines, read the sections relevant to your task — not the whole file.
+
+## Standards Loop
+
+This project follows a continuous standards loop:
+
+1. Standards files define what correct looks like
+2. Quality gates enforce it at every push (human or agent)
+3. Agents read standards before writing code and write to standards when new patterns emerge
+
+When you discover a pattern worth standardising, use \`/standards-aware\` to decide whether and how to add it.
+Without the standards, agents guess. Without the gates, the guesses reach the repo unchecked.`,
 
       'standards/workflows.md': `# Workflows
 
@@ -737,104 +772,118 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
 
       // Download commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/analyze.md`,
-        '.contextkit/commands/analyze.md'
+        `${this.repoUrl}/commands/dev/analyze.md`,
+        '.contextkit/commands/dev/analyze.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/review.md`,
-        '.contextkit/commands/review.md'
+        `${this.repoUrl}/commands/dev/review.md`,
+        '.contextkit/commands/dev/review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/fix.md`,
-        '.contextkit/commands/fix.md'
+        `${this.repoUrl}/commands/dev/fix.md`,
+        '.contextkit/commands/dev/fix.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/refactor.md`,
-        '.contextkit/commands/refactor.md'
+        `${this.repoUrl}/commands/dev/refactor.md`,
+        '.contextkit/commands/dev/refactor.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/run-tests.md`,
-        '.contextkit/commands/run-tests.md'
+        `${this.repoUrl}/commands/dev/run-tests.md`,
+        '.contextkit/commands/dev/run-tests.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/add-documentation.md`,
-        '.contextkit/commands/add-documentation.md'
+        `${this.repoUrl}/commands/docs/add-documentation.md`,
+        '.contextkit/commands/docs/add-documentation.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/quality-check.md`,
-        '.contextkit/commands/quality-check.md'
+        `${this.repoUrl}/commands/dev/quality-check.md`,
+        '.contextkit/commands/dev/quality-check.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-feature.md`,
-        '.contextkit/commands/create-feature.md'
+        `${this.repoUrl}/commands/dev/create-feature.md`,
+        '.contextkit/commands/dev/create-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-component.md`,
-        '.contextkit/commands/create-component.md'
+        `${this.repoUrl}/commands/dev/create-component.md`,
+        '.contextkit/commands/dev/create-component.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/spec.md`,
-        '.contextkit/commands/spec.md'
+        `${this.repoUrl}/commands/dev/spec.md`,
+        '.contextkit/commands/dev/spec.md'
       );
 
       // Download squad commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad.md`,
-        '.contextkit/commands/squad.md'
+        `${this.repoUrl}/commands/squad/squad.md`,
+        '.contextkit/commands/squad/squad.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-architect.md`,
-        '.contextkit/commands/squad-architect.md'
+        `${this.repoUrl}/commands/squad/squad-architect.md`,
+        '.contextkit/commands/squad/squad-architect.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-dev.md`,
-        '.contextkit/commands/squad-dev.md'
+        `${this.repoUrl}/commands/squad/squad-dev.md`,
+        '.contextkit/commands/squad/squad-dev.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-test.md`,
-        '.contextkit/commands/squad-test.md'
+        `${this.repoUrl}/commands/squad/squad-test.md`,
+        '.contextkit/commands/squad/squad-test.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-review.md`,
-        '.contextkit/commands/squad-review.md'
+        `${this.repoUrl}/commands/squad/squad-review.md`,
+        '.contextkit/commands/squad/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto.md`,
-        '.contextkit/commands/squad-auto.md'
+        `${this.repoUrl}/commands/squad/squad-auto.md`,
+        '.contextkit/commands/squad/squad-auto.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto-parallel.md`,
-        '.contextkit/commands/squad-auto-parallel.md'
+        `${this.repoUrl}/commands/squad/squad-auto-parallel.md`,
+        '.contextkit/commands/squad/squad-auto-parallel.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-reset.md`,
-        '.contextkit/commands/squad-reset.md'
+        `${this.repoUrl}/commands/squad/squad-reset.md`,
+        '.contextkit/commands/squad/squad-reset.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-doc.md`,
-        '.contextkit/commands/squad-doc.md'
+        `${this.repoUrl}/commands/squad/squad-doc.md`,
+        '.contextkit/commands/squad/squad-doc.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-ci.md`,
-        '.contextkit/commands/squad-ci.md'
+        `${this.repoUrl}/commands/squad/squad-ci.md`,
+        '.contextkit/commands/squad/squad-ci.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/health-check.md`,
-        '.contextkit/commands/health-check.md'
+        `${this.repoUrl}/commands/dev/health-check.md`,
+        '.contextkit/commands/dev/health-check.md'
       );
 
       // Download doc family commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-arch.md`,
-        '.contextkit/commands/doc-arch.md'
+        `${this.repoUrl}/commands/docs/doc-arch.md`,
+        '.contextkit/commands/docs/doc-arch.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-feature.md`,
-        '.contextkit/commands/doc-feature.md'
+        `${this.repoUrl}/commands/docs/doc-feature.md`,
+        '.contextkit/commands/docs/doc-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-component.md`,
-        '.contextkit/commands/doc-component.md'
+        `${this.repoUrl}/commands/docs/doc-component.md`,
+        '.contextkit/commands/docs/doc-component.md'
+      );
+
+      // Download agentic workflow commands
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/context-budget.md`,
+        '.contextkit/commands/agents/context-budget.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/agent-push-checklist.md`,
+        '.contextkit/commands/agents/agent-push-checklist.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/standards-aware.md`,
+        '.contextkit/commands/agents/standards-aware.md'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
@@ -937,15 +986,15 @@ claude "read .contextkit/context.md to see available standards, then create a bu
 - \`.contextkit/product/context.md\` - Domain-specific context
 
 ### Commands
-- \`.contextkit/commands/analyze.md\` - Analyze & customize standards
-- \`.contextkit/commands/review.md\` - Code review
-- \`.contextkit/commands/fix.md\` - Diagnose and fix bugs
-- \`.contextkit/commands/refactor.md\` - Refactor code structure
-- \`.contextkit/commands/run-tests.md\` - Generate or run tests
-- \`.contextkit/commands/add-documentation.md\` - Add documentation
-- \`.contextkit/commands/quality-check.md\` - Quality checks
-- \`.contextkit/commands/create-component.md\` - Create component
-- \`.contextkit/commands/create-feature.md\` - Create feature
+- \`.contextkit/commands/dev/analyze.md\` - Analyze & customize standards
+- \`.contextkit/commands/dev/review.md\` - Code review
+- \`.contextkit/commands/dev/fix.md\` - Diagnose and fix bugs
+- \`.contextkit/commands/dev/refactor.md\` - Refactor code structure
+- \`.contextkit/commands/dev/run-tests.md\` - Generate or run tests
+- \`.contextkit/commands/docs/add-documentation.md\` - Add documentation
+- \`.contextkit/commands/dev/quality-check.md\` - Quality checks
+- \`.contextkit/commands/dev/create-component.md\` - Create component
+- \`.contextkit/commands/dev/create-feature.md\` - Create feature
 
 ### Instructions
 - \`.contextkit/instructions/meta/pre-flight.md\` - Pre-flight checks
@@ -1066,15 +1115,15 @@ esac
         docs: 'docs',
       },
       commands: {
-        analyze: '@.contextkit/commands/analyze.md',
-        review: '@.contextkit/commands/review.md',
-        fix: '@.contextkit/commands/fix.md',
-        refactor: '@.contextkit/commands/refactor.md',
-        run_tests: '@.contextkit/commands/run-tests.md',
-        add_docs: '@.contextkit/commands/add-documentation.md',
-        quality_check: '@.contextkit/commands/quality-check.md',
-        create_component: '@.contextkit/commands/create-component.md',
-        create_feature: '@.contextkit/commands/create-feature.md',
+        analyze: '@.contextkit/commands/dev/analyze.md',
+        review: '@.contextkit/commands/dev/review.md',
+        fix: '@.contextkit/commands/dev/fix.md',
+        refactor: '@.contextkit/commands/dev/refactor.md',
+        run_tests: '@.contextkit/commands/dev/run-tests.md',
+        add_docs: '@.contextkit/commands/docs/add-documentation.md',
+        quality_check: '@.contextkit/commands/dev/quality-check.md',
+        create_component: '@.contextkit/commands/dev/create-component.md',
+        create_feature: '@.contextkit/commands/dev/create-feature.md',
       },
     };
 
@@ -1740,7 +1789,7 @@ enforcement:
 
     if (platform === 'cursor') {
       console.log(chalk.bold('In Cursor Chat:'));
-      console.log(`   @.contextkit/commands/analyze.md`);
+      console.log(`   @.contextkit/commands/dev/analyze.md`);
       console.log('');
       console.log('Or via CLI:');
       console.log(chalk.yellow('👉'), `/analyze`);
@@ -1766,7 +1815,7 @@ enforcement:
 
     if (platform === 'cursor') {
       console.log(chalk.bold('In Cursor Chat'));
-      console.log(`@.contextkit/commands/create-component.md`);
+      console.log(`@.contextkit/commands/dev/create-component.md`);
       console.log(chalk.dim('"Create a Button component for customer checkout"'));
       console.log('');
     }
@@ -1774,7 +1823,7 @@ enforcement:
     console.log(chalk.bold('In CLI'));
     console.log(
       chalk.dim(
-        "Use your AI tool's slash command, e.g. /analyze or @.contextkit/commands/create-component.md"
+        "Use your AI tool's slash command, e.g. /analyze or @.contextkit/commands/dev/create-component.md"
       )
     );
     console.log('');
@@ -1782,7 +1831,7 @@ enforcement:
     if (platform === 'claude' || platform === 'gemini') {
       const toolName = platform === 'claude' ? 'Claude' : 'Gemini';
       console.log(chalk.bold(`In ${toolName} CLI`));
-      console.log(`read .contextkit/commands/analyze.md and execute`);
+      console.log(`read .contextkit/commands/dev/analyze.md and execute`);
       console.log('');
     }
 
@@ -1973,6 +2022,59 @@ module.exports = [
     }
     return false;
   }
+
+  async createQualityGatesConfig() {
+    const configPath = '.contextkit/quality-gates.yml';
+    if (await fs.pathExists(configPath)) return;
+    const content = `# Quality Gates Configuration
+# Disable specific gates by uncommenting keys below.
+# All gates are enabled by default.
+# Reference: https://contextkit-docs.vercel.app/docs/quality-gates
+
+disabled:
+  # Node.js gates
+  # - typescript      # skip TypeScript type checking
+  # - eslint          # skip ESLint (direct, not via script)
+  # - prettier        # skip Prettier (direct, not via script)
+  # - format          # skip npm run format
+  # - lint            # skip npm run lint
+  # - build           # skip npm run build
+  # - test            # skip npm test
+  # - e2e             # skip npm run e2e
+  # Python gates
+  # - ruff-lint       # skip ruff/flake8 lint
+  # - typecheck       # skip mypy
+  # - ruff-format     # skip ruff/black format check
+  # - pytest          # skip pytest
+  # Rust gates
+  # - cargo-check     # skip cargo check
+  # - clippy          # skip cargo clippy
+  # - cargo-test      # skip cargo test
+  # Go gates
+  # - go-vet          # skip go vet
+  # - golangci-lint   # skip golangci-lint
+  # - go-test         # skip go test
+  # PHP gates
+  # - phpstan         # skip PHPStan
+  # - phpunit         # skip PHPUnit
+  # Ruby gates
+  # - rubocop         # skip RuboCop
+  # - rspec           # skip RSpec / rake test
+  # Java / Kotlin gates
+  # - maven-verify    # skip mvn verify
+  # - gradle-check    # skip gradle check
+  # - ktlint          # skip ktlint
+  # - kotlin-test     # skip gradle test
+  # Swift gates
+  # - swiftlint       # skip SwiftLint
+  # - swift-test      # skip swift test
+  # .NET gates
+  # - dotnet-build    # skip dotnet build
+  # - dotnet-test     # skip dotnet test
+`;
+    await fs.writeFile(configPath, content);
+    console.log(chalk.green('✅ Created .contextkit/quality-gates.yml'));
+  }
 }
 
 async function install(options) {

package/lib/commands/update.js

@@ -236,104 +236,116 @@ class UpdateCommand {
 
       // Download commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/analyze.md`,
-        '.contextkit/commands/analyze.md'
+        `${this.repoUrl}/commands/dev/analyze.md`,
+        '.contextkit/commands/dev/analyze.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/review.md`,
-        '.contextkit/commands/review.md'
+        `${this.repoUrl}/commands/dev/review.md`,
+        '.contextkit/commands/dev/review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/fix.md`,
-        '.contextkit/commands/fix.md'
+        `${this.repoUrl}/commands/dev/fix.md`,
+        '.contextkit/commands/dev/fix.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/refactor.md`,
-        '.contextkit/commands/refactor.md'
+        `${this.repoUrl}/commands/dev/refactor.md`,
+        '.contextkit/commands/dev/refactor.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/run-tests.md`,
-        '.contextkit/commands/run-tests.md'
+        `${this.repoUrl}/commands/dev/run-tests.md`,
+        '.contextkit/commands/dev/run-tests.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/add-documentation.md`,
-        '.contextkit/commands/add-documentation.md'
+        `${this.repoUrl}/commands/docs/add-documentation.md`,
+        '.contextkit/commands/docs/add-documentation.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/quality-check.md`,
-        '.contextkit/commands/quality-check.md'
+        `${this.repoUrl}/commands/dev/quality-check.md`,
+        '.contextkit/commands/dev/quality-check.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-feature.md`,
-        '.contextkit/commands/create-feature.md'
+        `${this.repoUrl}/commands/dev/create-feature.md`,
+        '.contextkit/commands/dev/create-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-component.md`,
-        '.contextkit/commands/create-component.md'
+        `${this.repoUrl}/commands/dev/create-component.md`,
+        '.contextkit/commands/dev/create-component.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/spec.md`,
-        '.contextkit/commands/spec.md'
+        `${this.repoUrl}/commands/dev/spec.md`,
+        '.contextkit/commands/dev/spec.md'
       );
 
       // Download squad commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad.md`,
-        '.contextkit/commands/squad.md'
+        `${this.repoUrl}/commands/squad/squad.md`,
+        '.contextkit/commands/squad/squad.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-architect.md`,
-        '.contextkit/commands/squad-architect.md'
+        `${this.repoUrl}/commands/squad/squad-architect.md`,
+        '.contextkit/commands/squad/squad-architect.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-dev.md`,
-        '.contextkit/commands/squad-dev.md'
+        `${this.repoUrl}/commands/squad/squad-dev.md`,
+        '.contextkit/commands/squad/squad-dev.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-test.md`,
-        '.contextkit/commands/squad-test.md'
+        `${this.repoUrl}/commands/squad/squad-test.md`,
+        '.contextkit/commands/squad/squad-test.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-review.md`,
-        '.contextkit/commands/squad-review.md'
+        `${this.repoUrl}/commands/squad/squad-review.md`,
+        '.contextkit/commands/squad/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto.md`,
-        '.contextkit/commands/squad-auto.md'
+        `${this.repoUrl}/commands/squad/squad-auto.md`,
+        '.contextkit/commands/squad/squad-auto.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto-parallel.md`,
-        '.contextkit/commands/squad-auto-parallel.md'
+        `${this.repoUrl}/commands/squad/squad-auto-parallel.md`,
+        '.contextkit/commands/squad/squad-auto-parallel.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-reset.md`,
-        '.contextkit/commands/squad-reset.md'
+        `${this.repoUrl}/commands/squad/squad-reset.md`,
+        '.contextkit/commands/squad/squad-reset.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-doc.md`,
-        '.contextkit/commands/squad-doc.md'
+        `${this.repoUrl}/commands/squad/squad-doc.md`,
+        '.contextkit/commands/squad/squad-doc.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-ci.md`,
-        '.contextkit/commands/squad-ci.md'
+        `${this.repoUrl}/commands/squad/squad-ci.md`,
+        '.contextkit/commands/squad/squad-ci.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/health-check.md`,
-        '.contextkit/commands/health-check.md'
+        `${this.repoUrl}/commands/dev/health-check.md`,
+        '.contextkit/commands/dev/health-check.md'
       );
 
       // Download doc family commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-arch.md`,
-        '.contextkit/commands/doc-arch.md'
+        `${this.repoUrl}/commands/docs/doc-arch.md`,
+        '.contextkit/commands/docs/doc-arch.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-feature.md`,
-        '.contextkit/commands/doc-feature.md'
+        `${this.repoUrl}/commands/docs/doc-feature.md`,
+        '.contextkit/commands/docs/doc-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-component.md`,
-        '.contextkit/commands/doc-component.md'
+        `${this.repoUrl}/commands/docs/doc-component.md`,
+        '.contextkit/commands/docs/doc-component.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/context-budget.md`,
+        '.contextkit/commands/agents/context-budget.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/agent-push-checklist.md`,
+        '.contextkit/commands/agents/agent-push-checklist.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/standards-aware.md`,
+        '.contextkit/commands/agents/standards-aware.md'
       );
 
       // Update CI squad workflow if the user opted in
@@ -426,15 +438,15 @@ paths:
 
 # Commands
 commands:
-  analyze: "${config.commands?.analyze || '@.contextkit/commands/analyze.md'}"
-  review: "${config.commands?.review || '@.contextkit/commands/review.md'}"
-  fix: "${config.commands?.fix || '@.contextkit/commands/fix.md'}"
-  refactor: "${config.commands?.refactor || '@.contextkit/commands/refactor.md'}"
-  run_tests: "${config.commands?.run_tests || '@.contextkit/commands/run-tests.md'}"
-  add_docs: "${config.commands?.add_docs || '@.contextkit/commands/add-documentation.md'}"
-  quality_check: "${config.commands?.quality_check || '@.contextkit/commands/quality-check.md'}"
-  create_component: "${config.commands?.create_component || '@.contextkit/commands/create-component.md'}"
-  create_feature: "${config.commands?.create_feature || '@.contextkit/commands/create-feature.md'}"
+  analyze: "${config.commands?.analyze || '@.contextkit/commands/dev/analyze.md'}"
+  review: "${config.commands?.review || '@.contextkit/commands/dev/review.md'}"
+  fix: "${config.commands?.fix || '@.contextkit/commands/dev/fix.md'}"
+  refactor: "${config.commands?.refactor || '@.contextkit/commands/dev/refactor.md'}"
+  run_tests: "${config.commands?.run_tests || '@.contextkit/commands/dev/run-tests.md'}"
+  add_docs: "${config.commands?.add_docs || '@.contextkit/commands/docs/add-documentation.md'}"
+  quality_check: "${config.commands?.quality_check || '@.contextkit/commands/dev/quality-check.md'}"
+  create_component: "${config.commands?.create_component || '@.contextkit/commands/dev/create-component.md'}"
+  create_feature: "${config.commands?.create_feature || '@.contextkit/commands/dev/create-feature.md'}"
 `;
 
     await fs.writeFile('.contextkit/config.yml', configContent);
@@ -465,7 +477,35 @@ commands:
   }
 
   async removeLegacyFiles() {
-    const legacyFiles = ['.contextkit/commands/squad-peer-review.md'];
+    const legacyFiles = [
+      // Removed in 0.14.0 — commands reorganised into dev/ squad/ docs/ agents/ subdirs
+      '.contextkit/commands/analyze.md',
+      '.contextkit/commands/review.md',
+      '.contextkit/commands/fix.md',
+      '.contextkit/commands/refactor.md',
+      '.contextkit/commands/run-tests.md',
+      '.contextkit/commands/add-documentation.md',
+      '.contextkit/commands/quality-check.md',
+      '.contextkit/commands/create-feature.md',
+      '.contextkit/commands/create-component.md',
+      '.contextkit/commands/spec.md',
+      '.contextkit/commands/health-check.md',
+      '.contextkit/commands/squad.md',
+      '.contextkit/commands/squad-architect.md',
+      '.contextkit/commands/squad-dev.md',
+      '.contextkit/commands/squad-test.md',
+      '.contextkit/commands/squad-review.md',
+      '.contextkit/commands/squad-auto.md',
+      '.contextkit/commands/squad-auto-parallel.md',
+      '.contextkit/commands/squad-reset.md',
+      '.contextkit/commands/squad-doc.md',
+      '.contextkit/commands/squad-ci.md',
+      '.contextkit/commands/doc-arch.md',
+      '.contextkit/commands/doc-feature.md',
+      '.contextkit/commands/doc-component.md',
+      // Older legacy
+      '.contextkit/commands/squad-peer-review.md',
+    ];
     for (const file of legacyFiles) {
       if (await fs.pathExists(file)) {
         await fs.remove(file);

package/lib/integrations/claude-integration.js

@@ -11,6 +11,59 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/rules/contextkit-standards.md',
       '.claude/rules/contextkit-testing.md',
       '.claude/rules/contextkit-code-style.md',
+      '.claude/skills/analyze/SKILL.md',
+      '.claude/skills/review/SKILL.md',
+      '.claude/skills/fix/SKILL.md',
+      '.claude/skills/refactor/SKILL.md',
+      '.claude/skills/test/SKILL.md',
+      '.claude/skills/doc/SKILL.md',
+      '.claude/skills/squad/SKILL.md',
+      '.claude/skills/squad-architect/SKILL.md',
+      '.claude/skills/squad-dev/SKILL.md',
+      '.claude/skills/squad-test/SKILL.md',
+      '.claude/skills/squad-review/SKILL.md',
+      '.claude/skills/squad-auto/SKILL.md',
+      '.claude/skills/squad-auto-parallel/SKILL.md',
+      '.claude/skills/squad-reset/SKILL.md',
+      '.claude/skills/squad-doc/SKILL.md',
+      '.claude/skills/spec/SKILL.md',
+      '.claude/skills/ck/SKILL.md',
+      '.claude/skills/doc-arch/SKILL.md',
+      '.claude/skills/doc-feature/SKILL.md',
+      '.claude/skills/doc-component/SKILL.md',
+      '.claude/skills/agent-push-checklist/SKILL.md',
+      '.claude/skills/context-budget/SKILL.md',
+      '.claude/skills/standards-aware/SKILL.md',
+    ];
+    this.platformDir = '.claude/rules';
+  }
+
+  async install() {
+    await super.install();
+    const fs = require('fs-extra');
+    await fs.ensureDir('.claude/skills');
+    await this.addToGitignore('.claude/settings.local.json');
+    await this.removeLegacyFiles();
+  }
+
+  async addToGitignore(entry) {
+    const fs = require('fs-extra');
+    if (!fs.existsSync('.gitignore')) return;
+    const content = await fs.readFile('.gitignore', 'utf-8');
+    if (content.includes(entry)) return;
+    const separator = content.endsWith('\n') ? '' : '\n';
+    await fs.appendFile('.gitignore', `${separator}${entry}\n`);
+  }
+
+  async removeLegacyFiles() {
+    const fs = require('fs-extra');
+    const legacyFiles = [
+      '.claude/rules/vibe-kit-standards.md',
+      '.claude/rules/vibe-kit-testing.md',
+      '.claude/rules/vibe-kit-code-style.md',
+      '.claude/commands/squad-batch.md',
+      '.claude/commands/squad-peer-review.md',
+      // Migrated to .claude/skills/ in 0.15.0
       '.claude/commands/analyze.md',
       '.claude/commands/review.md',
       '.claude/commands/fix.md',
@@ -31,25 +84,9 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/doc-arch.md',
       '.claude/commands/doc-feature.md',
       '.claude/commands/doc-component.md',
-    ];
-    this.platformDir = '.claude/rules';
-  }
-
-  async install() {
-    await super.install();
-    const fs = require('fs-extra');
-    await fs.ensureDir('.claude/commands');
-    await this.removeLegacyFiles();
-  }
-
-  async removeLegacyFiles() {
-    const fs = require('fs-extra');
-    const legacyFiles = [
-      '.claude/rules/vibe-kit-standards.md',
-      '.claude/rules/vibe-kit-testing.md',
-      '.claude/rules/vibe-kit-code-style.md',
-      '.claude/commands/squad-batch.md',
-      '.claude/commands/squad-peer-review.md',
+      '.claude/commands/agent-push-checklist.md',
+      '.claude/commands/context-budget.md',
+      '.claude/commands/standards-aware.md',
     ];
     for (const file of legacyFiles) {
       if (await fs.pathExists(file)) {
@@ -78,11 +115,11 @@ The following standards are auto-loaded into context via @imports:
 
 ## Commands
 
-- \`.contextkit/commands/analyze.md\` — Analyze and customize standards
-- \`.contextkit/commands/create-component.md\` — Create components
-- \`.contextkit/commands/create-feature.md\` — Create features
-- \`.contextkit/commands/run-tests.md\` — Run tests
-- \`.contextkit/commands/quality-check.md\` — Quality checks`;
+- \`.contextkit/commands/dev/analyze.md\` — Analyze and customize standards
+- \`.contextkit/commands/dev/create-component.md\` — Create components
+- \`.contextkit/commands/dev/create-feature.md\` — Create features
+- \`.contextkit/commands/dev/run-tests.md\` — Run tests
+- \`.contextkit/commands/dev/quality-check.md\` — Quality checks`;
   }
 
   async generateFiles() {
@@ -163,83 +200,137 @@ Follow the code style standards auto-loaded via CLAUDE.md (from code-style.md).
 `;
     await this.writeGeneratedFile('.claude/rules/contextkit-code-style.md', codeStyleRule);
 
-    // Slash commands — thin wrappers that delegate to .contextkit/commands/
+    // Skills — delegate to .contextkit/commands/ with rich frontmatter for Claude Code
     await this.writeGeneratedFile(
-      '.claude/commands/analyze.md',
-      `# Analyze Project
+      '.claude/skills/analyze/SKILL.md',
+      `---
+description: Analyze project and generate customized standards
+argument-hint: "[optional: scope or package path]"
+allowed-tools: Read, Glob, Grep, Write, Bash
+effort: high
+---
 
-Read \`.contextkit/commands/analyze.md\` and execute the analysis workflow for this project.
+Read \`.contextkit/commands/dev/analyze.md\` and execute the analysis workflow for this project.
 
 Scan the codebase structure, detect frameworks and patterns, then generate customized standards files in \`.contextkit/standards/\`.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/review.md',
-      `# Code Review
+      '.claude/skills/review/SKILL.md',
+      `---
+description: Review current changes for correctness and standards compliance
+argument-hint: "[optional: file or directory]"
+allowed-tools: Read, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/review.md\` and execute the review workflow.
+Read \`.contextkit/commands/dev/review.md\` and execute the review workflow.
 
 Review current changes for correctness, standards compliance, and potential issues.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/fix.md',
-      `# Fix Bug
+      '.claude/skills/fix/SKILL.md',
+      `---
+description: Diagnose root cause and implement a minimal bug fix with regression test
+argument-hint: "<description of the bug>"
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/fix.md\` and execute the bug fix workflow.
+Read \`.contextkit/commands/dev/fix.md\` and execute the bug fix workflow.
 
 Diagnose the root cause, implement the minimal fix, and add a regression test.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/refactor.md',
-      `# Refactor
+      '.claude/skills/refactor/SKILL.md',
+      `---
+description: Improve code structure without changing behavior
+argument-hint: "[optional: file or scope]"
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/refactor.md\` and execute the refactoring workflow.
+Read \`.contextkit/commands/dev/refactor.md\` and execute the refactoring workflow.
 
 Improve code structure without changing behavior, keeping tests green at every step.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/test.md',
-      `# Run Tests
+      '.claude/skills/test/SKILL.md',
+      `---
+description: Generate or run tests covering happy paths, edge cases, and errors
+argument-hint: "[optional: file or function]"
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/run-tests.md\` and execute the testing workflow.
+Read \`.contextkit/commands/dev/run-tests.md\` and execute the testing workflow.
 
 Generate or run tests for the specified code, covering happy paths, edge cases, and errors.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/doc.md',
-      `# Add Documentation
+      '.claude/skills/doc/SKILL.md',
+      `---
+description: Add inline docs, README sections, and usage examples
+argument-hint: "[optional: file or module]"
+allowed-tools: Read, Edit, Write, Glob, Grep
+effort: normal
+---
 
-Read \`.contextkit/commands/add-documentation.md\` and execute the documentation workflow.
+Read \`.contextkit/commands/docs/add-documentation.md\` and execute the documentation workflow.
 
 Add inline docs, README sections, and usage examples for the specified code.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/spec.md',
-      `# Spec
+      '.claude/skills/spec/SKILL.md',
+      `---
+description: Write a component spec (MD-first) before coding begins
+argument-hint: "<component or feature name>"
+allowed-tools: Read, Write, Glob, Grep
+effort: normal
+---
 
-Read \`.contextkit/commands/spec.md\` and execute the spec workflow.
+Read \`.contextkit/commands/dev/spec.md\` and execute the spec workflow.
 
 Write a component spec (MD-first) before any code is created. Scaffold the spec file colocated with the component and wait for review before coding begins.
 `
     );
 
-    // Squad slash commands
     await this.writeGeneratedFile(
-      '.claude/commands/squad.md',
-      `# Squad — Kickoff (start here)
+      '.claude/skills/ck/SKILL.md',
+      `---
+description: Check project setup, standards status, and integrations
+allowed-tools: Read, Glob, Grep, Bash
+effort: low
+---
+
+Read \`.contextkit/commands/dev/health-check.md\` and execute the health check workflow.
+
+Check project setup, standards status, and integrations. Report what needs attention.
+`
+    );
+
+    // Squad skills
+    await this.writeGeneratedFile(
+      '.claude/skills/squad/SKILL.md',
+      `---
+description: Squad pipeline kickoff — create handoff file and write PO spec
+argument-hint: '"<task description>"'
+allowed-tools: Read, Write, Glob, Grep
+effort: normal
+---
 
-Read \`.contextkit/commands/squad.md\` and execute the squad kickoff workflow.
+Read \`.contextkit/commands/squad/squad.md\` and execute the squad kickoff workflow.
 
 Create the handoff file and write the PO spec for the given task. Pass the user's task description as the input.
 
@@ -248,101 +339,130 @@ After kickoff, run \`/squad-auto\` to auto-run the full pipeline hands-free, or
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-architect.md',
-      `# Squad — Architect (manual step 1/4)
+      '.claude/skills/squad-architect/SKILL.md',
+      `---
+description: Write technical implementation plan from PO spec (manual step 1/4)
+allowed-tools: Read, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/squad-architect.md\` and execute the architect workflow.
+Read \`.contextkit/commands/squad/squad-architect.md\` and execute the architect workflow.
 
 Read the PO spec from the handoff file, design the technical approach, and write the implementation plan. Use \`/squad-auto\` instead to run all steps automatically.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-dev.md',
-      `# Squad — Dev (manual step 2/4)
+      '.claude/skills/squad-dev/SKILL.md',
+      `---
+description: Implement code changes following architect plan (manual step 2/4)
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/squad-dev.md\` and execute the dev workflow.
+Read \`.contextkit/commands/squad/squad-dev.md\` and execute the dev workflow.
 
 Follow the architect's plan to implement the code changes. Use \`/squad-auto\` instead to run all steps automatically.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-test.md',
-      `# Squad — Test (manual step 3/4)
+      '.claude/skills/squad-test/SKILL.md',
+      `---
+description: Write and run tests against acceptance criteria (manual step 3/4)
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/squad-test.md\` and execute the test workflow.
+Read \`.contextkit/commands/squad/squad-test.md\` and execute the test workflow.
 
 Write and run tests against the PO's acceptance criteria. Use \`/squad-auto\` instead to run all steps automatically.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-review.md',
-      `# Squad — Review (manual step 4/4)
+      '.claude/skills/squad-review/SKILL.md',
+      `---
+description: Review full handoff and write pass/needs-work verdict (manual step 4/4)
+allowed-tools: Read, Write, Glob, Grep, Bash
+effort: normal
+---
 
-Read \`.contextkit/commands/squad-review.md\` and execute the review workflow.
+Read \`.contextkit/commands/squad/squad-review.md\` and execute the review workflow.
 
 Review the full handoff (spec, plan, implementation, tests) and write the final verdict. Use \`/squad-auto\` instead to run all steps automatically.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-auto.md',
-      `# Squad Auto — Full Pipeline (recommended)
+      '.claude/skills/squad-auto/SKILL.md',
+      `---
+description: Auto-run full squad pipeline hands-free (architect → dev → test → review → doc)
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: high
+context: fork
+---
 
-Read \`.contextkit/commands/squad-auto.md\` and execute the pipeline runner workflow.
+Read \`.contextkit/commands/squad/squad-auto.md\` and execute the pipeline runner workflow.
 
 Run after \`/squad\` kickoff. Automatically runs architect → dev → test → review for all tasks sequentially, hands-free.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-auto-parallel.md',
-      `# Squad Auto — Parallel Agents (batch, fastest)
+      '.claude/skills/squad-auto-parallel/SKILL.md',
+      `---
+description: Auto-run squad pipeline with parallel agents — one per task per phase (fastest)
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: high
+context: fork
+---
 
-Read \`.contextkit/commands/squad-auto-parallel.md\` and execute the parallel pipeline workflow.
+Read \`.contextkit/commands/squad/squad-auto-parallel.md\` and execute the parallel pipeline workflow.
 
 Spawn one subagent per task per phase using the Task tool, so all tasks progress simultaneously instead of sequentially. Use this after \`/squad\` batch kickoff for faster execution on multi-task batches.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-reset.md',
-      `# Squad — Reset
+      '.claude/skills/squad-reset/SKILL.md',
+      `---
+description: Delete squad state to start fresh
+allowed-tools: Read, Write, Glob
+effort: low
+---
 
-Read \`.contextkit/commands/squad-reset.md\` and execute the reset workflow.
+Read \`.contextkit/commands/squad/squad-reset.md\` and execute the reset workflow.
 
 Delete the current squad state (.contextkit/squad/) so you can start fresh. Use when the squad folder is in a mixed or stuck state.
 `
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/squad-doc.md',
-      `# Squad — Doc (manual step 5/5)
+      '.claude/skills/squad-doc/SKILL.md',
+      `---
+description: Document changes after review passes (manual step 5/5)
+allowed-tools: Read, Edit, Write, Glob, Grep
+effort: normal
+---
 
-Read \`.contextkit/commands/squad-doc.md\` and execute the doc workflow.
+Read \`.contextkit/commands/squad/squad-doc.md\` and execute the doc workflow.
 
 After review passes, create or update companion .md files for every new/modified code file in this task. Use \`/squad-auto\` instead to run all steps automatically.
 `
     );
 
+    // Doc family skills
     await this.writeGeneratedFile(
-      '.claude/commands/ck.md',
-      `# ContextKit Health Check
-
-Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
-
-Check project setup, standards status, and integrations. Report what needs attention.
-`
-    );
-
-    // Doc family slash commands
-    await this.writeGeneratedFile(
-      '.claude/commands/doc-arch.md',
-      `# Doc — Architecture (Level 1)
+      '.claude/skills/doc-arch/SKILL.md',
+      `---
+description: Generate or update architecture documentation (Level 1)
+argument-hint: "[optional: PR number]"
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: high
+---
 
-Read \`.contextkit/commands/doc-arch.md\` and execute the architecture documentation workflow.
+Read \`.contextkit/commands/docs/doc-arch.md\` and execute the architecture documentation workflow.
 
 Detect the project stack, then generate or update \`docs/architecture.md\` with system boundaries, key flows, and stack-appropriate artifacts (Mermaid diagrams, component trees, service maps).
 
@@ -351,10 +471,15 @@ Pass an optional PR number to scope to that PR's changes.
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/doc-feature.md',
-      `# Doc — Feature (Level 2)
+      '.claude/skills/doc-feature/SKILL.md',
+      `---
+description: Generate or update feature documentation (Level 2)
+argument-hint: "[optional: feature name, path, or PR number]"
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+effort: high
+---
 
-Read \`.contextkit/commands/doc-feature.md\` and execute the feature documentation workflow.
+Read \`.contextkit/commands/docs/doc-feature.md\` and execute the feature documentation workflow.
 
 Detect the project stack, identify the target feature from the argument or current branch, then generate or update \`docs/features/<name>.md\` with purpose, components/modules, data flow, and user flows.
 
@@ -363,14 +488,62 @@ Pass a feature name, directory path, or PR number to scope the documentation.
     );
 
     await this.writeGeneratedFile(
-      '.claude/commands/doc-component.md',
-      `# Doc — Component (Level 3)
+      '.claude/skills/doc-component/SKILL.md',
+      `---
+description: Generate or update component documentation (Level 3)
+argument-hint: "[optional: file path or directory]"
+allowed-tools: Read, Edit, Write, Glob, Grep
+effort: normal
+---
 
-Read \`.contextkit/commands/doc-component.md\` and execute the component documentation workflow.
+Read \`.contextkit/commands/docs/doc-component.md\` and execute the component documentation workflow.
 
 Detect the project stack, read the target file or directory, then create or update a colocated \`<name>.md\` with API/props, usage examples, behavior, and edge cases.
 
 Pass a file path or directory to target. Omit to infer from current context.
+`
+    );
+
+    // Agent skills
+    await this.writeGeneratedFile(
+      '.claude/skills/agent-push-checklist/SKILL.md',
+      `---
+description: Pre-push quality checklist for agents before git push
+allowed-tools: Read, Glob, Grep, Bash
+effort: low
+---
+
+Read \`.contextkit/commands/agents/agent-push-checklist.md\` and execute the agent push checklist workflow.
+
+Run before pushing from an AI agent. Validates that changes are safe, tests pass, and the push is ready.
+`
+    );
+
+    await this.writeGeneratedFile(
+      '.claude/skills/context-budget/SKILL.md',
+      `---
+description: Check context consumption and advise on compact, summarise, or continue
+allowed-tools: Read, Glob, Grep
+effort: low
+---
+
+Read \`.contextkit/commands/agents/context-budget.md\` and execute the context budget workflow.
+
+Check how much context has been consumed and advise on whether to compact, summarise, or continue.
+`
+    );
+
+    await this.writeGeneratedFile(
+      '.claude/skills/standards-aware/SKILL.md',
+      `---
+description: Load and apply project standards before acting in an agentic context
+allowed-tools: Read, Glob, Grep
+effort: low
+---
+
+Read \`.contextkit/commands/agents/standards-aware.md\` and execute the standards-aware workflow.
+
+Load and apply the project's ContextKit standards before taking action in an agentic context.
 `
     );
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.13.7",
+  "version": "0.14.1",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {