JordanGunn/nunchuck / skills/prompt/prompt-forge
prompt-forge
VerifiedShape, refine, and stabilize human intent into a canonical prompt artifact. Iteratively clarifies ambiguity until user confirms readiness.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 938 B |
| assets/observability-template.md | markdown | 1.8 KB |
| assets/prompt-artifact-schema.json | config | 2.3 KB |
| assets/prompt-artifact-schema.md | markdown | 1.3 KB |
| assets/receipt-schema.json | config | 1.1 KB |
| references/00_ROUTER.md | markdown | 476 B |
| references/01_SUMMARY.md | markdown | 747 B |
| references/02_CONTRACTS.md | markdown | 1.1 KB |
| references/03_TRIGGERS.md | markdown | 462 B |
| references/04_NEVER.md | markdown | 425 B |
| references/05_ALWAYS.md | markdown | 482 B |
| references/06_PROCEDURE.md | markdown | 1.2 KB |
| references/07_FAILURES.md | markdown | 536 B |
| scripts/compile.ps1executable | script | 341 B |
| scripts/forge.ps1executable | script | 363 B |
| scripts/forge.shexecutable | script | 321 B |
| scripts/help.shexecutable | script | 510 B |
| scripts/include/prompt_forge_cli.py | script | 3.4 KB |
| scripts/include/prompt_parse.py | script | 6.7 KB |
| scripts/validate.shexecutable | script | 661 B |
references/06_PROCEDURE.md
View on GitHub---
description: Canonical execution path for this skill.
index:
- "Step 1: Check State"
- "Step 2: Propose Artifact Update"
- "Step 3: Persist Artifact Update"
- "Step 4: Mark Ready"
- "Step 5: Handoff"
---
# Procedure
## Step 1: Check State
Establish the current state of `.prompt/active.yaml` and surface validation errors:
```bash
./scripts/forge.sh
```
If the artifact does not exist, `forge.sh` creates an empty one.
## Step 2: Propose Artifact Update
From the conversation, propose an update to the artifact fields:
- `intent.objective`
- `intent.constraints`
- `intent.assumptions`
- `intent.open_questions`
- `prompt`
Present the proposed update to the user for confirmation.
## Step 3: Persist Artifact Update
Apply the confirmed changes by editing `.prompt/active.yaml`.
After writing, re-run `forge.sh` to surface status and any validation errors:
```bash
./scripts/forge.sh
```
## Step 4: Mark Ready
Only when the user explicitly confirms readiness, mark the artifact ready:
```bash
./scripts/forge.sh --mark-ready
```
If open questions remain, do not mark the artifact ready.
## Step 5: Handoff
Stop after the artifact is stable and ready. Subsequent actions happen in other skills.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |