skill-issue

Audit a new or unfamiliar project to understand its structure, health, risks, documentation gaps, and next actions. Use when initially entering a repo, assessing project quality, preparing onboarding, or asking what should be improved first.

Debug failing, flaky, slow, or incorrect behavior with a reproducible feedback loop. Use when something is broken, throwing, failing tests, behaving unexpectedly, or showing a performance regression.

Set up, validate, or run deployment for the current app on Cloudflare, a VPS, or a mixed architecture. Use when the user asks to deploy an app, configure deployment, set up CI/CD, choose a deployment target, document deployment, or fix deployment readiness.

Create or update project documentation, README sections, architecture docs, API docs, examples, migration notes, devops docs, runbooks, or usage guides. Use when the user asks to document behavior, explain usage, update docs after code changes, or remove stale documentation.

Create a concise handoff for another agent or future session to continue the work without replaying the conversation. Use when the user asks for a handoff, session summary, continuation note, or context transfer.

Investigate live or deployed-app issues by gathering evidence from health checks, logs, metrics, deploy history, config, and remote hosts. Use when the problem is happening outside the local dev loop: production, staging, a server, Cloudflare, VPS, CI/CD runtime, logs, alerts, or deployed behavior.

Plan and execute a cautious, multi-step improvement effort for a repository or major subsystem. Use when the user asks for a broad cleanup, modernization, technical debt pass, large refactor, or coordinated improvement across architecture, tests, docs, performance, reliability, and maintainability.

Build a clearly throwaway prototype to answer one design, logic, state, or UI question before committing to production code. Use when the user asks to prototype, mock up, try a design, sanity-check a model, or make something exploratory.

Review and refactor code within a specified scope. Use when the user asks to clean up, simplify, reduce duplication, remove dead code, or improve code quality in a file, module, or broader area of the codebase.

Prepare, validate, document, tag, or publish a software release. Use when the user asks to cut a release, prepare release notes, update changelog, bump a version, create a tag, or validate release readiness.

Review code changes or a selected code scope for correctness, regressions, missing tests, security risks, dependency risks, product mismatch, and mismatch with the requested behavior. Use when the user asks for a code review, PR review, branch review, diff review, security review, or review since a commit.

Ask another local AI CLI for feedback on a proposal, architecture, feature plan, refactor, review, or technical decision, then compare the feedback and produce a revised assessment. Use when the user wants another model's opinion or asks to check a plan with Gemini, Claude, Codex, Cursor, or another installed AI tool.

Add, update, or repair tests for behavior, regressions, and test-first development. Use when the user asks for tests, TDD, red-green-refactor, regression coverage, test repair, or behavior-driven implementation.