Agent skill

Spike Guidance Inline

by testdouble in testdouble/han

OI-3 spike harness — the INLINE (non-forked) readability-guidance variant.

MITAuto-check passedWriting & Content

Install Spike Guidance Inline

skills CLI
$ npx skills add testdouble/han --skill spike-guidance-inline -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install testdouble/han spike-guidance-inline --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/testdouble/han.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/plans/han-communication-plugin/artifacts/oi-3-spike/harness-skills/spike-guidance-inline .claude/skills/spike-guidance-inline && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spike-guidance-inline
GitHub stars
279
Token cost
~533 tokens
SKILL.md length
280 words
Files
1
Skills in repo
54
Repo updated
First seen
Licence
MIT

At a glance

OI-3 spike harness — the INLINE (non-forked) readability-guidance variant.

  • Tasks that involve Plain language and style rules
  • SKILL.md covers The audience frame (drafting…, What the standard requires and Self-check criteria…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Spike Guidance Inline is an agent skill from testdouble/han. 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.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Plain language and style rules. The repository describes itself as: Han: AI skills and agents for "Solo" product engineers and small teams. The licence is MIT.

When your agent uses it

  • Tasks that involve Plain language and style rules

Example prompts

  • “/spike-guidance-inline”

Requirements

  • Pre-approved tools (allowed-tools): Read

What it can do on your machine

Read from SKILL.md and the folder at commit abba73a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spike Guidance Inline loads about 533 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 280 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~533

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from testdouble/han at commit abba73a, republished under its MIT licence (© testdouble). 280 words, ~533 tokens.

Download SKILL.mdSave it as .claude/skills/spike-guidance-inline/SKILL.md (or your agent's skills folder).
name
spike-guidance-inline
description
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.
allowed-tools
Read

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 opening line state the main point? Does each paragraph carry one idea? Does each heading name its content? Any sentence past about thirty words is a candidate to split.


The standard is now surfaced into your context. Do not treat this guidance as your final answer. Proceed to the next step of the skill that invoked you and produce its deliverable.

© testdouble, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/plans/han-communication-plugin/artifacts/oi-3-spike/harness-skills/spike-guidance-inline of testdouble/han.

Open the folder on GitHubat commit abba73a

Compare with similar skills

Spike Guidance Inline next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spike Guidance Inline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spike Guidance Inline this skilltestdouble/han279—~533Automated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill3.9k—~4.1kAutomated safety check: PassMIT
Natural Japanese Business Writingcoji/natural-japanese1.9k—~2.1kAutomated safety check: PassMIT
Technical Writing Standardcursor/plugins10k10 repos~2.4kAutomated safety check: PassNone
PgjevrealZachi/pg-jev1k—~2.9kAutomated safety check: PassCustom licence
Defensive Writing Editorlennney/stop-that-shit2.5k1 repos~902Automated safety check: PassMIT

Similar skills

  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    3.9k GitHub stars~4.1k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.

    1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Official

    Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.

    10k GitHub starsUsed in 10 repos~2.4k tokens
    Writing & ContentAuto-check passed
  • Pgjev

    realZachi/pg-jev

    Install, configure, query and explain pgjev (the jev PostgreSQL extension that filters, ranks and classifies rows with plain-language conditions via TypeSafe's Jev model).

    1k GitHub stars~2.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Defensive Writing Editor

    lennney/stop-that-shit

    Cuts defensive disclaimers, stacked hedging and self-protective narration from proposals and summaries, keeping only limits that affect the reader's decision.

    2.5k GitHub starsUsed in 1 repo~902 tokens
    Writing & ContentAuto-check passed
  • C Code Style

    MaJerle/c-code-style

    Write, edit, or review C (and C-compatible header) code according to C coding style rules, then check and run clang-format to enforce formatting.

    1.4k GitHub stars~1.3k tokensUpdated 28 days ago
    Writing & ContentAuto-check passed

More from testdouble/han

All 54 skills in this repo
  • HTML Summary

    testdouble/han

    Convert a stakeholder summary markdown file into a single self-contained HTML executive report — bottom line and decision asks up front, supporting detail later — styled with a Test Double-derived…

    279 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Update Han plugin documentation so every skill, agent, guidance doc, index, and cross-reference is current and accurate.

    279 GitHub stars~3.4k tokensUpdated 6 days ago
    Auto-check passed
  • Guidance

    testdouble/han

    Authoritative guidance for building Claude Code skills, agents, and plugins, plus init and update steps that install and refresh the plugin-building skills in the current repository.

    279 GitHub stars~1.8k tokensUpdated 6 days ago
    Auto-check passed
  • Han Release

    testdouble/han

    Cut a Han release: update CHANGELOG.md with the changes since the last release, bump and tag every plugin that changed as {plugin-name}--v{version} so a version-constrained dependency can resolve…

    279 GitHub stars~8.6k tokensUpdated 6 days ago
    Auto-check passed
  • Plan Implementation

    testdouble/han

    Builds a feature implementation plan from an existing feature specification (or equivalent context) through a facilitated team conversation.

    279 GitHub stars~9.5k tokensUpdated 6 days ago
    Auto-check passed
  • Refactor

    testdouble/han

    Restructure existing code without changing its behavior, through a test-gated refactoring loop: a named target, a green suite over that target before any edit, a planned sequence of small named…

    279 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed

Questions about Spike Guidance Inline

What does Spike Guidance Inline do?

OI-3 spike harness — the INLINE (non-forked) readability-guidance variant. Spike Guidance Inline is an agent skill from testdouble/han. OI-3 spike harness — the INLINE (non-forked) readability-guidance variant.

When should I use Spike Guidance Inline?

Spike Guidance Inline fits situations like: tasks that involve Plain language and style rules.

How do I install Spike Guidance Inline in Claude Code?

Run `npx skills add testdouble/han --skill spike-guidance-inline -a claude-code`. Or copy the skill folder (docs/plans/han-communication-plugin/artifacts/oi-3-spike/harness-skills/spike-guidance-inline in testdouble/han) into .claude/skills/spike-guidance-inline in your project. Claude Code loads it when a task matches its description.

How do I install Spike Guidance Inline in Codex?

Run `npx skills add testdouble/han --skill spike-guidance-inline -a codex`. Or copy the skill folder (docs/plans/han-communication-plugin/artifacts/oi-3-spike/harness-skills/spike-guidance-inline in testdouble/han) into .agents/skills/spike-guidance-inline in your project. Codex loads it when a task matches its description.

Can I use Spike Guidance Inline in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add testdouble/han --skill spike-guidance-inline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spike-guidance-inline, .gemini/skills/spike-guidance-inline, .github/skills/spike-guidance-inline and .opencode/skills/spike-guidance-inline in your project.

What does Spike Guidance Inline need to run?

SKILL.md names no scripts, command-line tools or credentials: Spike Guidance Inline is instructions for the agent only. Its frontmatter pre-approves these tools: Read.

Does Spike Guidance Inline access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spike Guidance Inline safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spike Guidance Inline use?

Spike Guidance Inline is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spike Guidance Inline use?

About 533 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spike Guidance Inline?

Skills that share tags, products or a category with Spike Guidance Inline: Asd Ste100 (danyuchn/asd-ste100-skill, 3.9k stars), Natural Japanese Business Writing (coji/natural-japanese, 1.9k stars), Technical Writing Standard (cursor/plugins, 10k stars) and Pgjev (realZachi/pg-jev, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spike Guidance Inline?

testdouble (a GitHub organization) maintains it in testdouble/han, which has 279 GitHub stars. The repository holds 54 skills in this directory. The repository was last updated on October 1, 2026.

Source: testdouble/han on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.