cokit-cli 1.0.1 → 1.0.2

package/AGENTS.md

@@ -0,0 +1,103 @@
+# AGENTS.md
+
+## Project Overview
+
+CoKit is a collection of agents, prompts, instructions, and skills designed to enhance GitHub Copilot experiences. The project converts ClaudeKit resources to Awesome Copilot format for use with GitHub Copilot.
+
+- **Agents** - Specialized GitHub Copilot agents for various tasks
+- **Prompts** - Task-specific prompts for code generation and problem-solving
+- **Instructions** - Coding standards and best practices applied to specific file patterns
+- **Skills** - Self-contained folders with instructions and bundled resources
+- **Collections** - Curated collections organized around specific themes
+
+## Repository Structure
+
+```
+.
+├── agents/           # Custom agent definitions (.agent.md files)
+├── prompts/          # Task-specific prompts (.prompt.md files)
+├── instructions/     # Coding standards (.instructions.md files)
+├── skills/           # Agent Skills folders (SKILL.md + bundled assets)
+├── collections/      # Curated collections (.collection.yml files)
+├── docs/             # Documentation
+├── eng/              # Build and conversion scripts
+├── src/              # CLI source code
+├── bin/              # CLI entry point
+└── templates/        # Project templates for init command
+```
+
+## Setup Commands
+
+```bash
+# Install dependencies
+npm ci
+
+# Build (generate README.md)
+npm run build
+
+# Convert all ClaudeKit resources
+npm run convert:all
+
+# Convert individually
+npm run convert:agents
+npm run convert:commands
+npm run convert:skills
+```
+
+## Development Workflow
+
+### Working with Agents, Prompts, Instructions, and Skills
+
+All files must include proper markdown front matter:
+
+#### Agent Files (*.agent.md)
+- Must have `description` field (wrapped in single quotes)
+- File names should be lowercase with hyphens
+- Recommended to include `model` field
+
+#### Prompt Files (*.prompt.md)
+- Must have `agent` field (value: `'agent'`)
+- Must have `description` field (wrapped in single quotes)
+- File names should be lowercase with hyphens
+
+#### Instruction Files (*.instructions.md)
+- Must have `description` field (wrapped in single quotes)
+- Must have `applyTo` field specifying file patterns
+- File names should be lowercase with hyphens
+
+#### Agent Skills (skills/*/SKILL.md)
+- Each skill is a folder containing a `SKILL.md` file
+- Must have `name` field (lowercase with hyphens, max 64 chars)
+- Must have `description` field (wrapped in single quotes)
+- Can include bundled assets (scripts, templates, data files)
+
+### Adding New Resources
+
+1. Create the file with proper front matter
+2. Add to the appropriate directory
+3. Run `npm run build` to update README.md
+4. Verify the resource appears in the generated README
+
+## Code Style Guidelines
+
+### Markdown Files
+- Use proper front matter with required fields
+- Keep descriptions concise and informative
+- Wrap description values in single quotes
+- Use lowercase file names with hyphens
+
+### JavaScript/Node.js Scripts
+- Located in `eng/` and `src/` directories
+- Follow Node.js ES module conventions (.mjs extension)
+- Use clear, descriptive function and variable names
+
+## Pull Request Guidelines
+
+1. Run `npm run build` before committing
+2. Ensure all markdown files have required front matter
+3. Verify file names follow naming convention
+4. Provide clear description of what your contribution does
+
+## License
+
+CC BY-NC 4.0 - See [LICENSE](LICENSE) for details

package/README.FLOW.md

@@ -0,0 +1,237 @@
+# Copilot Flow Diagrams
+
+Visual diagrams showing how Copilot processes resources.
+
+---
+
+## Main Processing Flow
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                           USER INPUT                                         │
+│                    "/ck-cook implement login"                                │
+└─────────────────────────────────┬────────────────────────────────────────────┘
+                                  │
+                                  ▼
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  STEP 1: PROMPT LOADING                                                      │
+│  ────────────────────────────────────────────────────────────────────────    │
+│  Copilot finds file: prompts/ck-cook.prompt.md                               │
+│  Loads YAML front matter + body content                                      │
+│  ${input} = "implement login"                                                │
+└─────────────────────────────────┬────────────────────────────────────────────┘
+                                  │
+                                  ▼
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  STEP 2: AGENT ASSIGNMENT                                                    │
+│  ────────────────────────────────────────────────────────────────────────    │
+│  Prompt specifies: agent: 'agent' or agent: 'planner'                        │
+│  Copilot loads agent config from agents/*.agent.md                           │
+│  Agent receives context + instructions from prompt                           │
+└─────────────────────────────────┬────────────────────────────────────────────┘
+                                  │
+                                  ▼
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  STEP 3: INSTRUCTION INJECTION (Auto)                                        │
+│  ────────────────────────────────────────────────────────────────────────    │
+│  When agent works with files, Copilot checks glob patterns:                  │
+│                                                                              │
+│  Current file: src/components/Login.tsx                                      │
+│       ↓                                                                      │
+│  Check: applyTo: "**/*.tsx" → Match!                                         │
+│       ↓                                                                      │
+│  Inject: ck-frontend.instructions.md into context                            │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────┐          │
+│  │  Instructions injected in order:                               │          │
+│  │  1. copilot-instructions.md (global)                           │          │
+│  │  2. *.instructions.md matching pattern (file-specific)         │          │
+│  └────────────────────────────────────────────────────────────────┘          │
+└─────────────────────────────────┬────────────────────────────────────────────┘
+                                  │
+                                  ▼
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  STEP 4: SKILL ACTIVATION (On-demand)                                        │
+│  ────────────────────────────────────────────────────────────────────────    │
+│  Agent/User activates skill when specialized knowledge needed:               │
+│                                                                              │
+│  Prompt: "Use frontend-design skill for UI"                                  │
+│       ↓                                                                      │
+│  Load: skills/frontend-design/SKILL.md                                       │
+│       ↓                                                                      │
+│  Inject specialized knowledge into agent context                             │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────┐          │
+│  │  Skill may include:                                            │          │
+│  │  - SKILL.md (main instructions)                                │          │
+│  │  - Scripts (*.py, *.js)                                        │          │
+│  │  - Templates, examples                                         │          │
+│  └────────────────────────────────────────────────────────────────┘          │
+└─────────────────────────────────┬────────────────────────────────────────────┘
+                                  │
+                                  ▼
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  STEP 5: EXECUTION                                                           │
+│  ────────────────────────────────────────────────────────────────────────    │
+│  Agent executes with full context:                                           │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────┐             │
+│  │  AGENT CONTEXT                                              │             │
+│  │  ├── Prompt instructions (workflow)                         │             │
+│  │  ├── Global instructions (project rules)                    │             │
+│  │  ├── File instructions (pattern-matched)                    │             │
+│  │  ├── Activated skills (specialized knowledge)               │             │
+│  │  └── User input + conversation history                      │             │
+│  └─────────────────────────────────────────────────────────────┘             │
+│                                                                              │
+│  Agent actions: Read files → Generate code → Edit files → Run commands       │
+└─────────────────────────────────┬────────────────────────────────────────────┘
+                                  │
+                                  ▼
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  STEP 6: OUTPUT                                                              │
+│  ────────────────────────────────────────────────────────────────────────    │
+│  - Code changes applied                                                      │
+│  - Explanation/summary provided                                              │
+│  - Follow-up suggestions                                                     │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Resource Hierarchy
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                      COPILOT RESOURCES                          │
+├─────────────┬─────────────┬─────────────┬─────────────┬─────────┤
+│   Prompt    │    Agent    │ Instruction │    Skill    │Collection│
+│  (Workflow) │  (Executor) │   (Rules)   │ (Knowledge) │ (Bundle) │
+└─────────────┴─────────────┴─────────────┴─────────────┴─────────┘
+```
+
+---
+
+## Resource Relationships
+
+```
+Collection (Bundle)
+    │
+    ├── contains ──► Prompts (Workflows)
+    │                    │
+    │                    └── uses ──► Agents (Executors)
+    │                                     │
+    │                                     ├── auto-receives ──► Instructions (Rules)
+    │                                     │
+    │                                     └── can-activate ──► Skills (Knowledge)
+    │
+    └── contains ──► Instructions, Skills, Agents...
+```
+
+---
+
+## Instruction Injection Flow
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         FILE EDITING                                    │
+│                   User opens: src/App.tsx                               │
+└────────────────────────────────┬────────────────────────────────────────┘
+                                 │
+                                 ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│  PATTERN MATCHING                                                       │
+│  ─────────────────────────────────────────────────────────────────────  │
+│                                                                         │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │  File: src/App.tsx                                              │    │
+│  │                                                                 │    │
+│  │  Check instructions/*.instructions.md files:                    │    │
+│  │                                                                 │    │
+│  │  ├── ck-frontend.instructions.md                                │    │
+│  │  │   applyTo: "**/*.{tsx,jsx}" → MATCH ✓                        │    │
+│  │  │                                                              │    │
+│  │  ├── ck-testing.instructions.md                                 │    │
+│  │  │   applyTo: "**/*.test.ts" → NO MATCH ✗                       │    │
+│  │  │                                                              │    │
+│  │  └── ck-backend.instructions.md                                 │    │
+│  │      applyTo: "src/api/**/*.ts" → NO MATCH ✗                    │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+└────────────────────────────────┬────────────────────────────────────────┘
+                                 │
+                                 ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│  CONTEXT ASSEMBLY                                                       │
+│  ─────────────────────────────────────────────────────────────────────  │
+│                                                                         │
+│  Final context includes:                                                │
+│  1. copilot-instructions.md (global - always)                           │
+│  2. ck-frontend.instructions.md (matched)                               │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Skill Activation Flow
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                      SKILL NEEDED                                       │
+│            Agent needs specialized UI design knowledge                  │
+└────────────────────────────────┬────────────────────────────────────────┘
+                                 │
+                                 ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│  SKILL LOADING                                                          │
+│  ─────────────────────────────────────────────────────────────────────  │
+│                                                                         │
+│  Load: skills/frontend-design/                                          │
+│                                                                         │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │  Skill Package Contents:                                        │    │
+│  │                                                                 │    │
+│  │  frontend-design/                                               │    │
+│  │  ├── SKILL.md           ← Main instructions (loaded)            │    │
+│  │  ├── templates/                                                 │    │
+│  │  │   ├── component.tsx  ← Code templates (available)            │    │
+│  │  │   └── styles.css                                             │    │
+│  │  └── examples/                                                  │    │
+│  │      └── hero-section/  ← Reference examples (available)        │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+└────────────────────────────────┬────────────────────────────────────────┘
+                                 │
+                                 ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│  CONTEXT ENRICHMENT                                                     │
+│  ─────────────────────────────────────────────────────────────────────  │
+│                                                                         │
+│  Agent context now includes:                                            │
+│  - Original prompt workflow                                             │
+│  - Global + file-specific instructions                                  │
+│  - Skill knowledge (design principles, patterns, templates)             │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Comparison Matrix
+
+```
+┌─────────────┬──────────────┬──────────────┬────────────────┬───────────────┐
+│             │   Trigger    │    Scope     │   Persistence  │    Purpose    │
+├─────────────┼──────────────┼──────────────┼────────────────┼───────────────┤
+│ Prompt      │ /prompt-name │ Single task  │ Per invocation │ Workflow      │
+│ Agent       │ Prompt refs  │ Task exec    │ Per invocation │ Execution     │
+│ Instruction │ Auto (glob)  │ File-based   │ Always active  │ Rules/Style   │
+│ Skill       │ On-demand    │ Knowledge    │ When activated │ Expertise     │
+│ Collection  │ User install │ Resource set │ Permanent      │ Bundling      │
+└─────────────┴──────────────┴──────────────┴────────────────┴───────────────┘
+```
+
+---
+
+## One-liner Summary
+
+> User calls **Prompt** → Prompt uses **Agent** → Agent auto-receives **Instructions** by file pattern → Agent activates **Skills** when needed → All can be bundled in **Collection**.

package/README.md

@@ -2,111 +2,170 @@
 
 Make GitHub Copilot smarter in 30 seconds.
 
-[![npm version](https://img.shields.io/npm/v/cokit.svg)](https://www.npmjs.com/package/cokit)
-[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC%20BY--NC%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
+CoKit provides 15 agents, 64 prompts, 7 instructions, 27 skills, and 6 collections to supercharge your Copilot experience.
 
 ## Quick Start
 
 ```bash
-npx cokit init
+npx cokit-cli init -g
 ```
 
-That's it! Now open VS Code and try `/ck-fix` in Copilot Chat.
-
-## What You Get
-
-### Prompts (type in Copilot Chat)
-
-| Command | What it does |
-|---------|--------------|
-| `/ck-fix` | Debug and fix code issues |
-| `/ck-plan` | Create implementation plans |
-| `/ck-review` | Review code before committing |
-| `/ck-test` | Write tests for your code |
-| `/ck-code` | Implement from a plan |
-| `/ck-docs` | Update documentation |
-
-> **Why `ck-` prefix?** Prevents conflicts with other tools. Easy to identify CoKit prompts.
-
-### Skills (automatic)
-
-CoKit teaches Copilot how to:
-- Debug systematically (not randomly)
-- Review code like a senior dev
-- Plan before coding
-- Find documentation efficiently
-- Think through complex problems
+This installs all CoKit resources to `~/.copilot/` for global use.
 
 ## Installation Options
 
-### Option 1: Project Only (Recommended)
-
-```bash
-npx cokit init
-```
-
-Creates files in `.github/` - share with your team via git.
-
-### Option 2: Personal Skills
-
-```bash
-npx cokit init --global
-```
-
-Creates files in `~/.copilot/skills/` - works in all projects.
-
-### Option 3: Both
-
-```bash
-npx cokit init --all
-```
-
-## Commands
-
 | Command | Description |
 |---------|-------------|
-| `cokit init` | Set up CoKit in your project |
-| `cokit add <skill>` | Add a specific skill |
-| `cokit list` | Show available skills and prompts |
-| `cokit doctor` | Check your setup |
-| `cokit update` | Update to latest version |
-
-## Troubleshooting
-
-Run the doctor:
-
-```bash
-npx cokit doctor
-```
-
-### Common Issues
-
-**"Copilot doesn't see my prompts"**
-- Restart VS Code after running `npx cokit init`
-
-**"Skills not working"**
-- Enable in VS Code: Settings → `github.copilot.chat.useAgentSkills`
-
-**"Command not found"**
-- Make sure you have Node.js 18+ installed
-
-## For Claude Code Users
-
-Migrating from Claude Code? See [Migration Guide](docs/migration-guide.md).
-
-Key differences:
-- No hooks (static config only)
-- No subagents (single Copilot agent)
-- No `$ARGUMENTS` (user provides context in chat)
-
-## Documentation
-
-- [Quick Start](QUICK-START.md) - 30-second setup
-- [FAQ](FAQ.md) - Common questions
-- [Migration Guide](docs/migration-guide.md) - For Claude Code users
+| `npx cokit-cli init` | Interactive setup |
+| `npx cokit-cli init -g` | Install global resources only |
+| `npx cokit-cli init -a` | Install both project and global resources |
+
+## Resources
+
+## Agents
+
+| Agent | Description |
+|-------|-------------|
+| [brainstormer](agents/brainstormer.agent.md) | >-. |
+| [code-reviewer](agents/code-reviewer.agent.md) |  |
+| [database-admin](agents/database-admin.agent.md) |  |
+| [debugger](agents/debugger.agent.md) |  |
+| [docs-manager](agents/docs-manager.agent.md) |  |
+| [fullstack-developer](agents/fullstack-developer.agent.md) |  |
+| [git-manager](agents/git-manager.agent.md) | Stage, commit, and push code changes with conventional commits. |
+| [mcp-manager](agents/mcp-manager.agent.md) | Manage MCP (Model Context Protocol) server integrations - discover tools/prompts/resources, analyze ... |
+| [planner](agents/planner.agent.md) |  |
+| [project-manager](agents/project-manager.agent.md) | Use this agent when you need comprehensive project oversight and coordination. |
+| [researcher](agents/researcher.agent.md) |  |
+| [scout-external](agents/scout-external.agent.md) |  |
+| [scout](agents/scout.agent.md) |  |
+| [tester](agents/tester.agent.md) | Use this agent when you need to validate code quality through testing, including running unit and in... |
+| [ui-ux-designer](agents/ui-ux-designer.agent.md) |  |
+
+## Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| [ck-ask](prompts/ck-ask.prompt.md) | Answer technical and architectural questions. |
+| [ck-bootstrap-auto-fast](prompts/ck-bootstrap-auto-fast.prompt.md) |  |
+| [ck-bootstrap-auto-parallel](prompts/ck-bootstrap-auto-parallel.prompt.md) |  |
+| [ck-bootstrap-auto](prompts/ck-bootstrap-auto.prompt.md) |  |
+| [ck-bootstrap](prompts/ck-bootstrap.prompt.md) |  |
+| [ck-brainstorm](prompts/ck-brainstorm.prompt.md) |  |
+| [ck-ck-help](prompts/ck-ck-help.prompt.md) |  |
+| [ck-code-auto](prompts/ck-code-auto.prompt.md) |  |
+| [ck-code-no-test](prompts/ck-code-no-test.prompt.md) |  |
+| [ck-code-parallel](prompts/ck-code-parallel.prompt.md) |  |
+| [ck-code](prompts/ck-code.prompt.md) |  |
+| [ck-coding-level](prompts/ck-coding-level.prompt.md) | Set your coding experience level for tailored explanations and output format. |
+| [ck-cook-auto-fast](prompts/ck-cook-auto-fast.prompt.md) |  |
+| [ck-cook-auto-parallel](prompts/ck-cook-auto-parallel.prompt.md) |  |
+| [ck-cook-auto](prompts/ck-cook-auto.prompt.md) |  |
+| [ck-cook](prompts/ck-cook.prompt.md) |  |
+| [ck-debug](prompts/ck-debug.prompt.md) |  |
+| [ck-design-3d](prompts/ck-design-3d.prompt.md) |  |
+| [ck-design-describe](prompts/ck-design-describe.prompt.md) |  |
+| [ck-design-fast](prompts/ck-design-fast.prompt.md) |  |
+| [ck-design-good](prompts/ck-design-good.prompt.md) |  |
+| [ck-design-screenshot](prompts/ck-design-screenshot.prompt.md) |  |
+| [ck-design-video](prompts/ck-design-video.prompt.md) |  |
+| [ck-docs-init](prompts/ck-docs-init.prompt.md) |  |
+| [ck-docs-summarize](prompts/ck-docs-summarize.prompt.md) |  |
+| [ck-docs-update](prompts/ck-docs-update.prompt.md) |  |
+| [ck-fix-ci](prompts/ck-fix-ci.prompt.md) |  |
+| [ck-fix-fast](prompts/ck-fix-fast.prompt.md) |  |
+| [ck-fix-hard](prompts/ck-fix-hard.prompt.md) |  |
+| [ck-fix-logs](prompts/ck-fix-logs.prompt.md) |  |
+| [ck-fix-parallel](prompts/ck-fix-parallel.prompt.md) |  |
+| [ck-fix-test](prompts/ck-fix-test.prompt.md) |  |
+| [ck-fix-types](prompts/ck-fix-types.prompt.md) | Fix type errors |
+| [ck-fix-ui](prompts/ck-fix-ui.prompt.md) |  |
+| [ck-fix](prompts/ck-fix.prompt.md) |  |
+| [ck-git-cm](prompts/ck-git-cm.prompt.md) |  |
+| [ck-git-cp](prompts/ck-git-cp.prompt.md) |  |
+| [ck-git-merge](prompts/ck-git-merge.prompt.md) | ⚠️ Merge code from one branch to another |
+| [ck-git-pr](prompts/ck-git-pr.prompt.md) | Create a pull request |
+| [ck-kanban](prompts/ck-kanban.prompt.md) |  |
+| [ck-plan-archive](prompts/ck-plan-archive.prompt.md) |  |
+| [ck-plan-ci](prompts/ck-plan-ci.prompt.md) |  |
+| [ck-plan-cro](prompts/ck-plan-cro.prompt.md) |  |
+| [ck-plan-fast](prompts/ck-plan-fast.prompt.md) |  |
+| [ck-plan-hard](prompts/ck-plan-hard.prompt.md) |  |
+| [ck-plan-parallel](prompts/ck-plan-parallel.prompt.md) |  |
+| [ck-plan-two](prompts/ck-plan-two.prompt.md) |  |
+| [ck-plan-validate](prompts/ck-plan-validate.prompt.md) |  |
+| [ck-plan](prompts/ck-plan.prompt.md) |  |
+| [ck-preview](prompts/ck-preview.prompt.md) |  |
+| [ck-review-codebase](prompts/ck-review-codebase.prompt.md) |  |
+| [ck-scout-ext](prompts/ck-scout-ext.prompt.md) |  |
+| [ck-scout](prompts/ck-scout.prompt.md) |  |
+| [ck-skill-add](prompts/ck-skill-add.prompt.md) |  |
+| [ck-skill-create](prompts/ck-skill-create.prompt.md) |  |
+| [ck-skill-fix-logs](prompts/ck-skill-fix-logs.prompt.md) |  |
+| [ck-skill-optimize-auto](prompts/ck-skill-optimize-auto.prompt.md) |  |
+| [ck-skill-optimize](prompts/ck-skill-optimize.prompt.md) |  |
+| [ck-skill-plan](prompts/ck-skill-plan.prompt.md) |  |
+| [ck-test-ui](prompts/ck-test-ui.prompt.md) |  |
+| [ck-test](prompts/ck-test.prompt.md) |  |
+| [ck-use-mcp](prompts/ck-use-mcp.prompt.md) |  |
+| [ck-watzup](prompts/ck-watzup.prompt.md) | Review recent changes and wrap up the work |
+| [ck-worktree](prompts/ck-worktree.prompt.md) | Create isolated git worktree for parallel development |
+
+## Instructions
+
+| Instruction | ApplyTo | Description |
+|-------------|---------|-------------|
+| [ck-backend](instructions/ck-backend.instructions.md) | `**/*.py, *.go, *.rs, *.java, *.cs, api/**` | Backend development rules |
+| [ck-development](instructions/ck-development.instructions.md) | `**/*` | YAGNI/KISS/DRY principles |
+| [ck-frontend](instructions/ck-frontend.instructions.md) | `**/*.tsx, *.jsx, *.vue, *.svelte, components/**` | Frontend component guidelines |
+| [ck-frontend-design-pro](instructions/ck-frontend-design-pro.instructions.md) | `**/*.tsx, *.jsx, *.css` | Production-ready frontend with perfect images |
+| [ck-google-adk-python](instructions/ck-google-adk-python.instructions.md) | `**/*` | Google ADK Python guidelines |
+| [ck-research](instructions/ck-research.instructions.md) | `*` | Research guidelines |
+| [ck-testing](instructions/ck-testing.instructions.md) | `**/*.test.*, *.spec.*, test_*.py, *_test.go` | Testing standards |
+
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| [ck-ai-artist](skills/ck-ai-artist/SKILL.md) | Write and optimize prompts for AI-generated outcomes across text and image models. Use when crafting... |
+| [ck-backend-development](skills/ck-backend-development/SKILL.md) | Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJ... |
+| [ck-better-auth](skills/ck-better-auth/SKILL.md) | Implement authentication and authorization with Better Auth - a framework-agnostic TypeScript authen... |
+| [ck-chrome-devtools](skills/ck-chrome-devtools/SKILL.md) | Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automat... |
+| [ck-code-review](skills/ck-code-review/SKILL.md) | Use when receiving code review feedback (especially if unclear or technically questionable), when co... |
+| [ck-databases](skills/ck-databases/SKILL.md) | Work with MongoDB (document database, BSON documents, aggregation pipelines, Atlas cloud) and Postgr... |
+| [ck-debugging](skills/ck-debugging/SKILL.md) | Systematic debugging framework ensuring root cause investigation before fixes. Includes four-phase d... |
+| [ck-devops](skills/ck-devops/SKILL.md) | Deploy and manage cloud infrastructure on Cloudflare (Workers, R2, D1, KV, Pages, Durable Objects, B... |
+| [ck-docs-seeker](skills/ck-docs-seeker/SKILL.md) | Search technical documentation using executable scripts to detect query type, fetch from llms.txt so... |
+| [ck-frontend-design](skills/ck-frontend-design/SKILL.md) | Create distinctive, production-grade frontend interfaces with high design quality. Use when building... |
+| [ck-frontend-development](skills/ck-frontend-development/SKILL.md) | Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspens... |
+| [ck-markdown-novel-viewer](skills/ck-markdown-novel-viewer/SKILL.md) | Render markdown files with calm, book-like reading experience via background HTTP server. Features n... |
+| [ck-mcp-builder](skills/ck-mcp-builder/SKILL.md) | Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact wi... |
+| [ck-mcp-management](skills/ck-mcp-management/SKILL.md) | Manage Model Context Protocol (MCP) servers - discover, analyze, and execute tools/prompts/resources... |
+| [ck-media-processing](skills/ck-media-processing/SKILL.md) | Process multimedia files with FFmpeg (video/audio encoding, conversion, streaming, filtering, hardwa... |
+| [ck-mobile-development](skills/ck-mobile-development/SKILL.md) | Build modern mobile applications with React Native, Flutter, Swift/SwiftUI, and Kotlin/Jetpack Compo... |
+| [ck-payment-integration](skills/ck-payment-integration/SKILL.md) | Implement payment integrations with SePay (Vietnamese payment gateway with VietQR, bank transfers, c... |
+| [ck-planning](skills/ck-planning/SKILL.md) | Use when you need to plan technical solutions that are scalable, secure, and maintainable. |
+| [ck-problem-solving](skills/ck-problem-solving/SKILL.md) | Apply systematic problem-solving techniques for complexity spirals (simplification cascades), innova... |
+| [ck-repomix](skills/ck-repomix/SKILL.md) | Package entire code repositories into single AI-friendly files using Repomix. Capabilities include p... |
+| [ck-sequential-thinking](skills/ck-sequential-thinking/SKILL.md) | Apply structured, reflective problem-solving for complex tasks requiring multi-step analysis, revisi... |
+| [ck-shopify](skills/ck-shopify/SKILL.md) | Build Shopify applications, extensions, and themes using GraphQL/REST APIs, Shopify CLI, Polaris UI ... |
+| [ck-skill-creator](skills/ck-skill-creator/SKILL.md) | Guide for creating effective skills, adding skill references, skill scripts or optimizing existing s... |
+| [ck-threejs](skills/ck-threejs/SKILL.md) | Build immersive 3D web experiences with Three.js - WebGL/WebGPU library for scenes, cameras, geometr... |
+| [ck-ui-styling](skills/ck-ui-styling/SKILL.md) | Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind... |
+| [ck-ui-ux-pro-max](skills/ck-ui-ux-pro-max/SKILL.md) | Frontend UI/UX design intelligence - activate FIRST when user requests beautiful, stunning, or aesth... |
+| [ck-web-frameworks](skills/ck-web-frameworks/SKILL.md) | Build modern full-stack web applications with Next.js (App Router, Server Components, RSC, PPR, SSR,... |
+
+## Collections
+
+| Collection | Description |
+|------------|-------------|
+| [CK Core Workflows](collections/ck-core.collection.yml) | Core CoKit workflows combining all essential agents, prompts, and skills for full-stack development ... |
+| [CK Development Rules](collections/ck-development-rules.collection.yml) | Essential development rules and best practices including YAGNI, KISS, DRY principles, file naming, c... |
+| [CK Documentation Management](collections/ck-documentation.collection.yml) | Documentation management workflows for maintaining project docs, codebase summaries, design guidelin... |
+| [CK Git Workflow](collections/ck-git-workflow.collection.yml) | Git workflow automation including commit, push, merge, and pull request management. |
+| [CK Orchestration Protocol](collections/ck-orchestration.collection.yml) | Workflow orchestration patterns for managing subagents, task delegation, and multi-phase implementat... |
+| [CK UI/UX Design](collections/ck-ui-design.collection.yml) | UI/UX design workflows with frontend development, styling, multimodal AI for image generation, and d... |
 
 ## License
 
-CC BY-NC 4.0 - Free for personal and educational use.
-
-Commercial use requires a license. Contact for details.
+CC BY-NC 4.0 - See [LICENSE](LICENSE) for details.