skills/AlignPrompt/SKILL.md
Fix indentation, fence language tags, heading depth, and frontmatter fields to match forge conventions. USE WHEN an adopted community skill or any prompt-shaped document fails a forge convention check (indent, fence, heading, schema).
npx skillsauth add n4m3z/forge-core AlignPromptInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Bring a prompt-shaped document into forge convention without changing its meaning. Referenced by ForgeAdopt as the align transform.
| Axis | Forge convention |
| ----------------- | ------------------------------------------------------------------------------ |
| Indentation | Four spaces. No tabs. Applies to markdown, YAML, TOML, JSON, code blocks. |
| Fence tags | Every fenced code block carries a language tag. Use sh, not bash. |
| Heading depth | Max depth 3. No skipped levels (no H1 to H3 without H2 between). |
| Heading style | One H1 per document, matching the skill name in PascalCase. |
| Frontmatter keys | name, description, version. Strip upstream fields forge does not use. |
| Skill name | PascalCase, two words, scope plus focus (for example SecurityBestPractices). |
| Table alignment | Pipes line up vertically; pad cells with spaces to the widest column. |
| Trailing newline | Every text file ends with a single \n. |
| Wikilinks / paths | Spaces literal, not URL-encoded. |
argument-hint, allowed-tools, hooks)development
Reactive correction and root-cause fix. USE WHEN something went wrong, user is frustrated, demands a correction, says wtf, what the hell, why did you, that's wrong, this is broken, no not that, stop. Executes the immediate fix, then hunts the upstream artifact that caused it and creates a corrective change.
development
Decompose a research question into sub-queries, spawn parallel WebResearcher agents per angle, synthesize findings with citations and explicit confidence. USE WHEN the user asks to research, investigate, look online, look up, dig into, find sources, gather evidence, or survey what's known about a topic. Single-pass; for multi-round adversarial research use ResearchCouncil in forge-council.
tools
Author project documentation that future humans (and AI sessions) actually read. Covers TLDRs for tools, READMEs, runbooks, journals. USE WHEN write documentation, create tldr, tool one-pager, document a cli, write readme, runbook, journal entry, capture knowledge about a tool, distill a session into reusable notes.
development
Review your own staged changes via a code-review TUI before triggering a commit. USE WHEN about to commit, walking through your own staged diff, self-reviewing before approval, tuicr, revdiff, git diff cached.