Claude Code Skills, Agents & Workflows

Built by TRAN Le Khanh ([email protected]) — developer and AI tooling author.

Modular packages that extend Claude Code with specialized knowledge, workflows, and tool integrations.

Quick Navigation: Quick Reference | Common Workflows | Skill Index

🔒 Access Notice

This package has limited access. To get access to the npm package and repository:

📧 Email: [email protected]

Include your use case and I'll send you an invitation.

Quick Start

CLI Installation (Recommended)

# Install globally (npm registry)
npm install -g @khanhcan148/mk

# Install kit to current project (./.claude/)
mk init

# Install kit globally (~/.claude/ — available in all projects)
mk init --global

# Preview what would be installed without writing files
mk init --dry-run

Note: This package has limited access. Email [email protected] for an invitation to access the npm package and repository.

CLI Commands

mk init              Install kit files to current project (./.claude/)
mk init --global     Install kit globally (~/.claude/)
mk init --dry-run    Preview what would be installed
mk update            Update kit files (preserves your edits by default)
mk update --force    Update and overwrite user-modified files
mk remove            Remove all kit files tracked by manifest
mk --version         Show installed CLI version
mk --help            Show help

Manual Installation (Alternative)

For contributors with repository access:

# Clone the repository (requires access to private repo)
git clone https://github.com/khanhtran148/mk-kit.git
cd mk-kit

Project-level usage (skills available in one project):

cp -r .claude /path/to/your/project/

Global-level usage (skills available across all projects):

cp -r .claude ~/.claude/

Usage

# Use a workflow command
/mk-init           # Bootstrap new project
/mk-brainstorm     # Explore options, debate trade-offs
/mk-plan           # Create implementation plan
/mk-implement      # End-to-end feature delivery
/mk-test           # Run tests and validate
/mk-review         # Code quality review
/mk-debug          # Debug issues
/mk-security       # Security scan and audit
/mk-db             # Database operations
/mk-docs           # Generate documentation
/mk-git            # Git operations
/mk-audit          # Code archaeology chain: orientation, testing, heatmap, breaking-change analysis, technical debt, domain extraction
/mk-skill-creator  # Create and scaffold new Claude Code skills with automated validation
/mk-selftest       # Self-validation checks on kit agents, skills, docs, workflows

Structure

├── .claude/
│   ├── agents/      # 29 agents (5 primary + 24 utility: implementers, quality, docs, specialized, concerns)
│   ├── skills/      # 58 skill packages (SKILL.md + scripts/references/assets)
│   │   ├── mk-*/    # 16 workflow commands (/mk-audit, /mk-brainstorm, /mk-skill-creator, /mk-selftest, etc.)
│   │   └── ...      # Domain skills (frontend, backend, testing, etc.)
│   └── workflows/   # Development protocols
├── bin/             # CLI entry point (mk command)
├── src/             # CLI source code
├── docs/            # Project documentation
│   └── plans/       # Implementation plans (created during development)
├── package.json     # npm package metadata
├── CLAUDE.md        # Claude Code guidance
└── README.md        # This file

Primary Workflow

Orchestration is handled by /mk-* skills which spawn utility agents as needed. See Common Workflows for practical examples.

Architecture:

User → /mk-* command (skill) → spawns utility agents → agents use knowledge skills

Sequential chaining:

/mk-plan → /mk-implement → /mk-test → /mk-review

Entry point commands:

| Command | Purpose | |---------|---------| | /mk-init | Full project bootstrap from conception to deployment; includes brownfield detection (Phase 0 gate) and adoption workflow (B1-B4.5 stages) | | /mk-brainstorm | Ideation, requirements exploration, structured debate (analyzer opus agent) | | /mk-audit | Code archaeology chain: orientation report, characterization testing, topology heatmap, breaking-change analysis, technical debt dashboard, domain extraction | | /mk-plan | Create implementation plans with phases and tasks (opus) | | /mk-design | UI/UX wireframes, design systems, mockups | | /mk-implement | End-to-end feature delivery (sonnet) | | /mk-test | Run tests, analyze coverage, validate builds | | /mk-review | Code review for quality, security, performance | | /mk-debug | Debugging workflow: investigate, diagnose, fix, verify | | /mk-security | Security-first workflow: dependency scan, secrets detection | | /mk-db | Database operations: diagnose, optimize, design, migrate | | /mk-docs | Generate and update project documentation | | /mk-git | Git operations: branch, commit, push, PR, merge | | /mk-research | Deep multi-source research on technical topics | | /mk-skill-creator | Create and scaffold new Claude Code skills with automated SKILL.md, scripts, references, and agent | | /mk-selftest | Run self-validation checks on kit agents, skills, docs, and workflows |

Primary Agents

Invoked directly via /mk-* skills:

| Agent | Purpose | Model | |-------|---------|-------| | analyzer | Deep research, decision matrix, architecture diagrams, adversarial debate (Phases 5-8 of /mk-brainstorm) | opus | | planner | Implementation planning with phases, tasks, dependencies | opus | | implementer | End-to-end feature implementation | sonnet | | database-admin | Database operations: diagnose, optimize, design, migrate | sonnet | | git-manager | Git operations: commit, push, PR, merge | haiku |

Utility Agents

Spawned by primary agents for domain-specific work:

Implementation & Quality (8) | Agent | Purpose | |-------|---------| | backend-implementer | API and domain logic implementation | | frontend-implementer | UI components, consuming API contract | | tester | Test execution and validation | | debugger | Issue investigation and diagnosis | | refactorer | Refactoring with TFD-first safety workflow |

Docs & Project Management (3) | Agent | Purpose | |-------|---------| | project-manager | Progress tracking, roadmap updates | | docs-manager | Documentation maintenance | | journal-writer | Technical difficulty documentation |

Research & Design (3) | Agent | Purpose | |-------|---------| | researcher | Technical research | | ui-ux-designer | Frontend design | | copywriter | Marketing copy and content |

Utilities & Search (2) | Agent | Purpose | |-------|---------| | scout | Codebase file search (internal) | | scout-external | Codebase search via external tools | | mcp-manager | MCP server integrations |

Parallel Concern Review Agents (10) | Agent | Purpose | |-------|---------| | quality-reviewer | Code quality, readability, maintainability (mk-review concern) | | security-reviewer | Security vulnerabilities, threat analysis (mk-review concern) | | performance-reviewer | Performance profiling, optimization opportunities (mk-review concern) | | tfd-reviewer | Test-first development verification (mk-review concern) | | dep-scanner | Dependency vulnerability scanning (mk-security concern) | | secret-scanner | Secrets and credential detection (mk-security concern) | | code-security-reviewer | Code-level security analysis (mk-security concern) | | infra-reviewer | Infrastructure security review (mk-security concern) | | log-analyzer | Log analysis and diagnostics (mk-debug concern) | | hypothesis-generator | Root cause hypothesis generation (mk-debug concern) |

Full agent details →

Skills

See Skill Index for a complete categorized list of all skills.

Each skill contains:

• SKILL.md (required) - Instructions (<100 lines)
• scripts/ (optional) - Executable code with tests
• references/ (optional) - Documentation chunks
• assets/ (optional) - Templates, images

# Create new skill (recommended)
/mk-skill-creator

# Or use scripts directly
.claude/skills/mk-skill-creator/scripts/init_skill.py <skill-name> --path <output-directory>
.claude/skills/mk-skill-creator/scripts/package_skill.py <path/to/skill-folder>

Documentation

| Document | Description | |----------|-------------| | Skill Index | Categorized list of all skills and workflows | | mk-* Workflows & Agents | How each /mk-* command works and which agents it uses | | Project Overview & PDR | Requirements, constraints, success metrics | | Project Roadmap | Phases, milestones, and risk register | | Changelog | Version history and release notes | | Code Standards | Conventions, naming, quality gates | | System Architecture | Component diagrams, data flow | | Product Domain Glossary | Core domain concepts, terminology, and ecosystem definitions | | Quick Reference | Common commands and quick lookup | | Common Workflows | Practical workflow examples |

Core Principles

• YAGNI - Don't add functionality until necessary
• KISS - Prefer simple solutions
• DRY - Extract common patterns
• SOLID - For OOP/enterprise projects

Key Constraints

• SKILL.md must be under 100 lines
• Referenced markdown files also under 100 lines
• Scripts must include tests
• Cross-platform compatibility (Windows + macOS/Linux) is mandatory: Scripts use Python or Node.js only — no bash/shell scripts
• Token efficiency - minimize context usage

Compatibility

This skill kit works in both Claude Code CLI and VSCode GitHub Copilot (1.108+).

Cross-Platform Compatibility

This kit is designed to work on Windows, macOS, and Linux:

• Scripts: All executable scripts use Python or Node.js (no bash/shell scripts)
• Claude Code Bash tool: Provides a Unix-like shell on all platforms, including Windows — git commands and other Bash tool invocations work everywhere
• External tool installs: Reference files include install instructions for macOS (brew), Ubuntu/Debian (apt-get), and Windows (winget/choco) where applicable
• Agent fallbacks: Agents using CLI-only tools (TodoWrite, BashOutput, MultiEdit) document VSCode Copilot fallback behavior inline

| Feature | Claude Code CLI | VSCode Copilot (1.108+) | |---------|----------------|------------------------| | Skills (SKILL.md) | Full support | Full support | | Agents (.md) | Full support | Full support | | CLAUDE.md | Full support | Full support | | Model field | Shorthand (opus/sonnet/haiku) | Shorthand (recommended) | | Task tool | Native Task() syntax | Natural language delegation* | | color | Supported | Ignored (harmless) | | MCP tools | Full support | Limited | | AskUserQuestion | Native UI | Natural language fallback |

*VSCode Copilot users: Use natural language to invoke agents (e.g., "Use the planner agent to create a plan"). The explicit Task() syntax is Claude Code CLI-specific.

CLI-only tools: TodoWrite, BashOutput, KillShell, MultiEdit are Claude Code-specific. Agents gracefully fall back to standard tools (Write, Bash, sequential Edit) when these are unavailable.