batch-fixUse to apply review findings or several small independent corrections across more than 3 files in one batch, with no new contract or architecture — broader than fix, lighter than implement.
brainstormingUse before spec writing when the approach is unclear, several designs or ways to build it are plausible, or the engineer wants to explore alternatives before committing.
code-review-and-qualityReview a PR (pull request), branch or diff outside implement — runs the compliance, silent-failure, test and architecture lanes with full lane accounting.
code-simplificationUse after a feature or fix is verified to simplify the changed code without changing behavior — wraps Claude Code's /simplify with finance and security carve-outs.
context-engineeringUse when starting a session, switching between planning/implementation/review phases, entering unfamiliar code, or when output drifts from project norms.
fixUse for a bug, failing test, error or small config change whose fix stays within 1-3 files and needs no formal spec — escalates to implement if the scope grows.
handoffUse when handing in-progress work to a teammate or ending a session with unfinished, uncommitted work — writes a short recovery note with branch, state, decisions and resume steps.
implementUse for substantial work that adds a feature, a public contract such as an endpoint, or a multi-file behavior change; the full loop of spec, plan, batched implementation, verification and review.
incremental-implementationUse when executing an approved multi-file implementation to ensure each batch compiles, tests, and stays within the approved manifest.
instructionsAudit AGENTS.md/CLAUDE.md for rot with verify-references/verify-commands, or capture a session's discovered commands and gotchas — append-only diffs, applied only with approval.
lessonsTeam lessons lifecycle — capture a correction or golden path, mine past transcripts, refresh stale anchors, promote native memory to tasks/lessons.md; reject-by-default, writes need approval.
mtk-doctorMTK install health check — core files, hooks, integrity, active config and environment, with JSON output, safe auto-repair and raw usage counts; use when MTK seems broken or misconfigured.
mtk-setupOne-stop setup entry point that bootstraps a repo or re-runs architecture audit
mtkUnified entry point that routes natural language requests to the right MTK skill
planning-and-task-breakdownUse after a spec is approved and before multi-file implementation begins, to break work into verifiable batches with checkpoints.
pre-commit-reviewFast security-focused review of staged changes before every commit, checking only critical compliance rules
prior-work-checkUse before approving a spec or starting a multi-file implementation to confirm no existing skill, helper, or handler already covers the proposed work.
promote-lessonDeprecated alias for `lessons promote` (kept for one release) — promotes a native-memory rule to the team-wide tasks/lessons.md.
repo-healthPeriodic AI-readiness report — 9-asset action checklist, audit drift, and suggest-only reviewer-feedback phrases mined from the last N merged PRs.
research-contextUse when a decision needs current external info, not local sources — latest-version behavior, recommended practices, upgrade or migration guides; researches the web and returns a cited brief.
security-and-hardeningUse when the change touches auth, secrets, audited state, audit trails, infrastructure, or external inputs — treat security as a design constraint, not final polish.
setup-auditAudit the repo to extract architecture principles, or with --merge unify audits from multiple repos into a single team-wide document
setup-bootstrapOne-time repo setup that detects tech stack, audits the codebase, pulls coding guidelines, and generates a project-specific AGENTS.md plus a CLAUDE.md shim
setup-refreshRefresh generated setup artifacts (principles, conventions, detected tools, AGENTS.md, configs, indexes) against codebase drift — proposes diffs for engineer-edited files instead of overwriting.
spec-drift-detectionUse after implementation completes and before review begins, to verify the actual change matches the approved spec — files touched, public contracts added, security impact, and declared scope.
spec-driven-developmentUse when the task is a new feature, breaking change or multi-file change whose spec and design should be approved before any code is written.
subagent-implementationUse instead of incremental-implementation for 3+ batches, 6+ non-mechanical files, or non-none security_impact — one fresh implementer subagent per batch with orchestrator drift checks.
tech-stack-dotnet.NET stack context for workflow skills — dotnet build, test and migration commands, EF Core and MediatR patterns, analyzer setup, C# coding guidelines and reference file paths.
tech-stack-pythonPython stack context for workflow skills — pytest, mypy and ruff commands, SQLAlchemy and Alembic guidance, FastAPI, Django and Flask patterns, and reference file paths.
tech-stack-typescriptTypeScript/JavaScript stack context — package manager build and test commands (Vitest, Jest), Prisma and Drizzle guidance, React, React Native/Expo, Next.js, Tauri and Node patterns.
verification-before-completionUse before reporting any task, batch or fix as complete — requires fresh evidence from tests or commands actually run for every completion claim.
workflow-artifactsUse to create, update, and read durable workflow state under .mtk/workflows/ so orchestration survives compaction, crash, and session handoff.
writing-skillsUse when creating a new skill for this toolkit — ensures the skill follows the anatomy, CSO principle, and is tested against agent rationalizations before shipping.