n4m3z/RefinePrompt

RefinePrompt

Six transforms for refining a prompt-shaped document. Apply each independently or in sequence; each is also composable by AdoptArtifact during community-skill adoption.

Decide what to apply

| Transform | Apply when | | --------- | ---------------------------------------------------------------------------- | | Align | Indent, fence tags, heading depth, frontmatter, or table alignment is off | | Debrand | Hardcoded vendor names or external-service dependencies bias the artifact | | Minimize | Motivational, marketing, or filler prose; emphasis inflation | | Rescope | allowed-tools: '*' or unnecessarily broad grants | | Extract | SKILL.md body has bulk reference material that does not need to be loaded | | Adapt | Porting prompts from this repo to a downstream/consumer repo |

Transforms

@Align.md

@Debrand.md

@Minimize.md

@Rescope.md

@Extract.md

@Adapt.md

Cross-cutting constraints

• Never rewrite content to change meaning. Refine structure, remove rot, narrow scope; do not paraphrase.
• Preserve anti-pattern lists, concrete examples, command/regex/schema blocks, and runtime-critical frontmatter (name, description, version, allowed-tools, argument-hint, hooks).
• Recompute the artifact's SHA-256 after every transform and sync it to the provenance sidecar if one exists. The sidecar's subject.digest.sha256 must match the current file content.
• When in doubt, preserve and flag for human review rather than transform silently.