to-guide

Generates step-by-step implementation guides with ready-to-paste AI IDE prompts for human-coded tickets.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/PVMalove/claude-agent-harness --skill to-guide-pvmalove
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: to-guide
Source: https://github.com/PVMalove/claude-agent-harness/tree/main/skills/first-party/pvmalove/to-guide
Command: npx skills add https://github.com/PVMalove/claude-agent-harness --skill to-guide-pvmalove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a ticket is routed to a human developer (hitl) instead of an autonomous agent, the developer still needs a concrete plan: which files to touch, in what order, and how to leverage an AI IDE like Cursor or Copilot Chat. This Skill turns a fully specified ticket or spec into a structured implementation guide with copy-paste-ready prompts, so the human can execute narrow, verifiable steps without re-deriving the plan. ## Core Features & Use Cases - Ticket-to-Guide Conversion: Reads a hitl ticket (GitHub/GitLab issue or local markdown tracker), verifies it is unblocked and fully specified, claims and marks it in-progress, then drafts the guide. - Codebase-Grounded Planning: Explores the actual repository to identify exact files to create or update, respecting ADRs and the project glossary rather than guessing from ticket text. - Ready-to-Paste Prompts: Produces small, compilable steps, each with a self-contained prompt that cites existing files to imitate and requests tests first (TDD). - Use Case: A maintainer picks up a hitl ticket from an epic, runs this Skill, and receives a guide in docs/tasks/ with a file map, per-step IDE prompts, verification commands, and a closing checklist covering code review, commit, qa-gate, and PR. ## Quick Start Ask the agent to run /to-guide on a specific hitl ticket number or local issue file to generate its implementation guide.

Frequently Asked Questions about to-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a ticket into an implementation guide for manual coding?▼

Run the to-guide skill with the ticket's issue number, URL, or local markdown path. It reads the ticket, explores the codebase, and writes a guide to docs/tasks with a file map, per-step AI IDE prompts, and verification commands.

What is the difference between hitl and afk tickets in this workflow?▼

afk tickets go to /implement, where the agent writes the code itself. hitl tickets go to /to-guide, which produces a manual implementation guide with prompts so a human developer writes the code in an AI IDE like Cursor or Copilot Chat.

Can I generate a guide for a ticket that is still blocked or unspecified?▼

No. The skill checks workflow::blocked labels and open blockers first and stops if any remain. If the ticket lacks workflow::ready or the hitl marker, it asks for confirmation before proceeding.

Does the guide support languages other than English?▼

Yes. The guide is written in the language set by the language field in .harness/project.json, defaulting to Russian if the file or field is absent. The entire document, including prompts, follows that setting.

What happens after the human finishes coding from the guide?▼

The skill does not review, commit, run qa-gate, or open the PR. The guide's closing section instructs the developer to run /code-review, commit with a semantic message, run /qa-gate, and then open the PR or mark the local ticket done.