Command catalog

15 manual commands, 15 auto skills, and 1 reference skill.

Kiyo is designed primarily for Claude Code. The same simplified catalog remains compatible with OpenAI Codex and GitHub Copilot. Host priority order: Claude Code native-first > Codex compatible > GitHub Copilot compatible > OpenCode CLI compatible. OpenCode CLI compatibility is currently documented as portable Markdown guidance. A first-class OpenCode host package is future work.

How a command runs

Every command loads Project Memory and focused source evidence before touching code, stays inside one bounded mission, and ends with a Runtime Verification status.

User intent to Choose one /kiyo command to Load Project Memory to Read focused source evidence to Plan or change inside one mission to Runtime Verification status

Host command form

Native-first and highest priority host.

How to choose

Pick the command that matches your intent, not your implementation detail. If the work is analysis only, choose a deep read-only command. If it changes code, choose a standard or strict mission and expect Runtime Verification at the end.

Use this when something is broken and you want the smallest safe fix. The agent first discovers where the bug lives instead of assuming the layer, so it works across backend, frontend, or both.

Workflow

  • Reproduce or reason from the smallest available evidence.
  • Trace the root cause through the affected layer or layers.
  • Patch only the code needed for the defect.
  • Add or update regression coverage when the project has a suitable test pattern.
  • Run the relevant verification command when possible.

Output

  • Root cause summary with evidence.
  • Changed files and why each was touched.
  • Regression test or explanation when a test cannot be added.
  • Runtime Verification status.

Guardrails

  • Does not broaden into unrelated cleanup.
  • Does not claim fixed without runtime evidence.
  • Escalates if the bug touches auth, secrets, production configuration, schema, or destructive changes.

Example

/kiyo-bug-fix "cart total becomes 0 after applying a coupon"

Auto skills

Auto skills are not command choices.

Auto skills are discipline rules. Claude Code and Codex can trigger them from descriptions. GitHub Copilot receives the same behavior through always-on instructions because Copilot does not have description-based skill auto-triggering.

kiyo-context-loader

Reads Project Memory first.

Before suggesting or applying any change, it reads project-profile.md, project-structure.md, and ai-working-rules.md (plus any area-specific pattern file) so project facts drive the answer, not generic training data, then applies the Mandatory Priority Order before proposing anything.

Trigger: Code change, refactor, add, or explain in a Kiyo-initialized repo

kiyo-safe-change

Escalates to strict Safety Mode and requires approval planning.

Once a risk trigger fires, it forces strict Safety Mode, requires an explicit Verification Plan and Rollback Plan, and blocks the change from being applied until the user approves it. Read-only investigation is still allowed while approval is pending.

Trigger: Migration, schema, auth, secret, production, delete, remove, or upgrade risk

kiyo-evidence-discipline

Requires file and line evidence for non-obvious claims.

Every non-obvious claim must cite a specific file:line or Project Memory entry. Confidence Labels such as [high] or [low] are forbidden; the response ends with an explicit Verification Status instead of a vague confidence gesture.

Trigger: Review, audit, explanation, or investigation

kiyo-no-hallucination

Blocks invented project facts and uses Unknown when evidence is missing.

Forbids inventing files, APIs, schemas, services, or a specific stack — Clean Architecture, CQRS, MediatR, EF Core, Angular, SQL Server, and similar defaults are never assumed. When Project Memory or source code cannot confirm a fact, the response writes Unknown or Not enough evidence rather than guessing.

Trigger: Stack, schema, API, library, or architecture decisions

kiyo-token-efficient-context

Reads focused evidence instead of the whole repository.

Reads Project Memory first, then a handful of directly relevant source files, and only expands further when a stated trigger requires it — an unclear root cause, conflicting evidence, or a security/auth impact. Generated folders such as bin/, node_modules/, and dist/ are never scanned by default.

Trigger: Investigation, fix, review, add, refactor, or test

kiyo-session-memory

Maintains project-local memory under .kiyo/project/memory/.

Keeps a small, git-tracked MEMORY.md index plus on-demand detail files so decisions with a non-obvious "why", user feedback, and deferred findings survive across sessions. It never mirrors what git log or the codebase can already answer cheaper.

Trigger: Past decisions, deferred findings, or non-obvious session facts

kiyo-clarify-ambiguity

Asks before writing the wrong code.

When a request to implement, fix, or refactor has more than one reasonable interpretation, a missing required input, or an unclear scope boundary, it presents the distinct readings and asks which one the user wants instead of silently picking one.

Trigger: A request has multiple reasonable meanings

kiyo-simplicity-first

Keeps the solution small and avoids speculative abstractions.

Forbids speculative features, abstractions built for a single caller, premature generalization, and configuration for cases that do not exist yet. The standing test: would a senior engineer reviewing this diff call it overcomplicated?

Trigger: New code or design work

kiyo-surgical-change

Keeps the diff limited to the requested change.

Restricts an edit to the lines the request actually names — no drive-by refactors, reformatting, or comment cleanup on adjacent code. Problems spotted outside the change boundary are recorded as Deferred Findings, not fixed in the same diff.

Trigger: Editing existing code

kiyo-existing-pattern-first

Follows existing structure, naming, test style, and boundaries.

Treats the project's own structure, naming, and validation style as the reference point instead of a textbook architecture. Blocks introducing CQRS, MediatR, FluentValidation, a new ORM, or a new layer unless the project already uses it or the user explicitly asks.

Trigger: A project already has patterns

kiyo-runtime-verification

Requires runtime evidence before claiming Verified.

Requires an actual build, test run, lint, or safe HTTP call before a response can claim a change works, and forbids faking command output. Every code-changing response ends with exactly one status: Verified, Implemented but not verified, Not verified, or Could not verify.

Trigger: Any code-changing task

kiyo-ui-ux-design

Routes design work through the UI/UX design discipline when available.

Delegates color, typography, layout, and component-style decisions to the ui-ux-pro-max skill when it is installed, ranking its recommendation below the project's own design system. If the skill is not installed, it says so plainly and falls back to safe baseline guidance instead of inventing palettes or fonts.

Trigger: UI, UX, visual design, or design system work

kiyo-compact-response

Keeps replies compact without removing risks, evidence, or verification.

Chooses a Compactness Mode — standard, compact, or ultra — for the reply's wording, defaulting to compact for ordinary work and forcing standard back on for security audits, migrations, and other completeness-critical tasks. It never trims evidence, risk warnings, approval gates, or the Runtime Verification status to save words.

Trigger: Coding, review, audit, planning, or follow-up responses

kiyo-skill-router

Scans the Manual mission-skill catalog before generic freeform work starts.

When the user has not already named a skill or /kiyo-<name> command, it compares the stated goal against all 15 Manual mission skills and announces the single best match with its command and default Safety Mode, or asks the user to choose explicitly when two or more commands fit equally well. It never adopts a Manual skill's mission or Safety Mode commitment without that confirmation.

Trigger: A request describes a goal in the user's own words without already naming a skill or command

dotnet-clean-architecture-cqrs

Gives .NET architecture guidance only when the project supports it.

When evidence supports Clean Architecture, a modular monolith, CQRS/MediatR, and EF Core, it gives layer dependency rules (Api → Application → Domain), solution folder conventions, and pragmatic guidance for controllers, validators, and tests — conditional on evidence, never assumed by default.

Trigger: Project evidence confirms .NET Clean Architecture or CQRS

angular-developer

Provides Angular guidance while still following project patterns first.

Reference skill bundled from Google's official Angular guide (not Kiyo-authored). Covers components, signals, forms, dependency injection, routing, styling, and testing, scoped to the project's detected Angular version.

Trigger: Angular evidence is present