to-prompt

name	to-prompt
description	Turn code, issues, or context into a handoff brief for another LLM — full context, zero prescribed solution, written to docs/prompts/. Use when packaging a bug fix, an improvement, or a feature request for an external LLM to implement. Don't use for prompts that already prescribe an implementation, simple one-shot questions, or end-user-facing copy.
metadata	{"author":"Pedro Nauck","github":"https://github.com/pedronauck","repository":"https://github.com/pedronauck/skills"}

To Prompt

Write a brief, not a solution. The brief carries everything the receiving LLM needs to choose the implementation itself — the problem, the current state, the requirements, the constraints — and stops exactly where the "how" begins: the receiving LLM owns the how. Code appears only as evidence of what exists today, never as the fix.

Every brief is a file: docs/prompts/<YYYYMMDD-HHmm>_<slug>.md (e.g. docs/prompts/20260709-1745_fix-auth-redirect.md).

Steps

1. Classify the task — bug fix, improvement, or feature — and draft a one-paragraph statement of the problem and the outcome wanted.
2. Gather the evidence. Read the code paths involved; quote current code as it exists; capture error messages, logs, and stack traces verbatim; note environment and recent changes. Done when: every claim in the brief is backed by something you actually read or ran.
3. Write the brief from the template. Copy assets/brief-template.md to docs/prompts/<YYYYMMDD-HHmm>_<slug>.md (create the directory if absent; slug = lowercase-hyphenated summary; timestamp = now). Fill every section following the template's per-type guidance comments, then delete the comments. Done when: every section is filled or carries an explicit Unknown — <reason> line — a silent gap reads as "nothing to say" to the receiver — and no guidance comment remains.
4. Sweep for leaked solutions. Reread the file; wherever a suggested approach, a pattern to follow, a step-by-step plan, or after-state code slipped in, delete it and keep only the requirement it was smuggling. Done when: the brief answers "what" everywhere and "how" nowhere.
5. Hand off. Reply with the file path and a one-line summary of what the brief asks for.

Bundled files

• assets/brief-template.md — the brief's skeleton and per-type coverage guidance; the single source of truth for what a complete brief contains.