spike-guidance-inline

Solid

OI-3 spike harness — the INLINE (non-forked) readability-guidance variant. Surfaces the shared readability standard into the calling skill's own context. Use only when a spike consumer skill invokes it.

Web & Frontend 224 stars 21 forks Updated today MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
78
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
93
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Readability Guidance (inline variant) You have invoked the readability-guidance skill to source the shared writing standard before you draft prose. This content is now in your context. Apply it while you draft, then RETURN to the workflow that called you — this guidance is a means to writing your deliverable, not the deliverable itself. Emit the line `SPIKE_GUIDANCE_MARKER_5R8_INLINE` once, to confirm the guidance rendered, then continue. ## The audience frame (drafting stage) While drafting, write for a capable reader who did not do this work and lacks the author's context. This single instruction is the most practical lever for plain output: it steers away from insider shorthand, unstated assumptions, and the author's own mental model. ## What the standard requires - **Main point first.** The opening line states the bottom line. A reader who stops after one sentence still gets the answer. - **One idea per paragraph.** Each paragraph carries one idea; its first sentence carries the weight. - **Descriptive headings.** Each heading names its content ("Why the request times out," not "Analysis"). - **Short, active sentences.** Roughly fifteen to twenty words on average; few past twenty-five. - **Common words.** Prefer the common word over the technical synonym. - **Numbered lists for steps, bullets for the rest.** - **Progressive disclosure.** Reveal the core first and detail in layers. ## Self-check criteria (post-draft stage) After the draft exists, check: does the ...

Details

Author
testdouble
Repository
testdouble/han
Created
3 months ago
Last Updated
today
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Solid

spike-guidance-forked

OI-3 spike harness — the FORKED (context fork) readability-guidance variant. Same payload as the inline variant but declared to run in a forked context. Use only when a spike consumer skill invokes it.

224 Updated today
testdouble
Code & Development Featured

spike-consumer-inline

OI-3 spike harness — heavy consumer skill, INLINE arm. Builds an incident post-mortem and sources the readability standard mid-workflow via an inline (non-forked) guidance skill. Use only when explicitly invoked by the spike harness with a TRIAL_ID and data path.

224 Updated today
testdouble
Code & Development Featured

readability-guidance

Surfaces Han's shared Human-Readable Output Standard — the readability rule and the writing-voice profile — into the calling skill's own context, so the caller drafts in voice and runs its self-check against the current standard sourced from one canonical copy. Use when a prose-producing skill needs the shared readability standard available in context before it drafts. Governs the shape of a written deliverable, where explanation-guidance governs what a run says to a person in a turn. Runs in the caller's context and hands control straight back; it does not produce a deliverable of its own, rewrite anything, or judge the caller's work. Does not run the adversarial rewrite pass — dispatch the readability-editor agent for that, or use edit-for-readability to rewrite an existing target. Does not cover explaining technical work to a reader who will not implement it — use explanation-guidance for that.

224 Updated today
testdouble