Agent skill

Outline Refiner

by WILLOSCAR in WILLOSCAR/research-units-pipeline-skills

Planner-pass coverage + redundancy report for an outline+mapping, producing outline/coveragereport.md and outline/outlinestate.jsonl.

No licenceAuto-check passedTesting & QA

Install Outline Refiner

skills CLI
$ npx skills add WILLOSCAR/research-units-pipeline-skills --skill outline-refiner -a claude-code

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

GitHub CLI
$ gh skill install WILLOSCAR/research-units-pipeline-skills outline-refiner --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/WILLOSCAR/research-units-pipeline-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/outline-refiner .claude/skills/outline-refiner && 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
outline-refiner
GitHub stars
513
Token cost
~824 tokens
SKILL.md length
336 words
Files
2 (incl. scripts)
Skills in repo
107
Repo updated
First seen
Licence
None found

At a glance

Planner-pass coverage + redundancy report for an outline+mapping, producing outline/coveragereport.md and outline/outlinestate.jsonl.

  • Works in 6 steps: Parse outline/outline.yml to enumerate… → Read outline/mapping.tsv and compute… → If papers/paper_notes.jsonl exists,… → …
  • Tasks that involve Test coverage
  • SKILL.md covers Triggers & routing, Inputs, Outputs and Workflow (planner pass, NO…, plus 3 more sections
  • Runs Python scripts from its folder; calls uv

What it does

Outline Refiner is an agent skill from WILLOSCAR/research-units-pipeline-skills. Planner-pass coverage + redundancy report for an outline+mapping, producing outline/coveragereport.md and outline/outlinestate.jsonl.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/run.py`).

It sits in Testing & QA, covering Test coverage. The repository describes itself as: Research pipelines as semantic execution units: each skill declares inputs/outputs, acceptance criteria, and guardrails. Evidence-first methodology prevents hollow writing…

When your agent uses it

  • Tasks that involve Test coverage

Example prompts

  • “/outline-refiner”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Parse outline/outline.yml to enumerate H2 sections + H3 subsections (section sizing / budget).
  2. Read outline/mapping.tsv and compute per-H3 coverage and reuse hotspots.
  3. If papers/paper_notes.jsonl exists, summarize evidence levels (fulltext/abstract/title) for mapped papers.
  4. If outline/subsection_briefs.jsonl exists, compute axis specificity (generic vs specific axes) per H3.
  5. Optionally use GOAL.md to flag obvious scope drift (keywords not reflected in outline).
  6. Write outline/coverage_report.md and append a run record to outline/outline_state.jsonl.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    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

Outline Refiner loads about 824 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 336 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 336 words (~824 tokens).

“Goal: make the outline auditable by adding an explicit planner stage that answers:”

— opening of SKILL.md by WILLOSCAR
name
outline-refiner

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .codex/skills/outline-refiner of WILLOSCAR/research-units-pipeline-skills.

  • SKILL.md
  • scripts/run.py

Open the folder on GitHubat commit c92912a

Compare with similar skills

Outline Refiner 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.

Outline Refiner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outline Refiner this skillWILLOSCAR/research-units-pipeline-skills513—~824Automated safety check: PassNone
Requirementsrizsotto/Bear6.5k—~2kAutomated safety check: PassGPL-3.0
Crap Analysisardalis/RiverBooks1352 repos~3.4kAutomated safety check: PassNone
Code Coverages3s-project/s3s311—~789Automated safety check: PassApache-2.0
Project Statusbactopia/bactopia522—~787Automated safety check: PassMIT
Check Coverageldayton/Dippy243—~403Automated safety check: PassMIT

Similar skills

  • Requirements

    rizsotto/Bear

    Write, modify, or review a requirement file under docs/requirements -- pick the single owning file, keep the text contract-only, name IDs so they need no explanation, and verify cross-references and…

    6.5k GitHub stars~2k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Crap Analysis

    ardalis/RiverBooks

    Analyze code coverage and CRAP (Change Risk Anti-Patterns) scores to identify high-risk code.

    135 GitHub starsUsed in 2 repos~3.4k tokens
    Testing & QAAuto-check passed
  • Code Coverage

    s3s-project/s3s

    Measure and grow the line coverage of the s3s crate. An agent skill from s3s-project/s3s.

    311 GitHub stars~789 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Project Status

    bactopia/bactopia

    Show a live snapshot of the Bactopia project state — component counts, GroovyDoc coverage, nf-test coverage, and structural issues.

    522 GitHub stars~787 tokensUpdated 2 mo ago
    Testing & QAAuto-check passed
  • Check Coverage

    ldayton/Dippy

    Ensure comprehensive test coverage for a CLI handler. An agent skill from ldayton/Dippy.

    243 GitHub stars~403 tokensUpdated 3 mo ago
    Testing & QAAuto-check passed
  • Guarding Destructive Operations

    kajisho5/ffmpeg-skill

    Add and review preconditions on operations that delete, overwrite, rewrite history, or resolve a caller-supplied name to a filesystem path — refusing instead of warning, placing the guard ahead of…

    1.9k GitHub stars~2.6k tokensUpdated 4 days ago
    Testing & QAAuto-check passed

More from WILLOSCAR/research-units-pipeline-skills

All 107 skills in this repo
  • Appendix Table Writer

    WILLOSCAR/research-units-pipeline-skills

    Curate reader-facing survey tables for the Appendix (clean layout + high information density), using only in-scope evidence and existing citation keys.

    513 GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • Artifact Contract Auditor

    WILLOSCAR/research-units-pipeline-skills

    Audit one research Workspace for declared Unit outputs and Pipeline target Artifacts, writing output/CONTRACTREPORT.md; use for mid-Run coverage snapshots or final delivery completeness, not deep…

    513 GitHub stars~918 tokensUpdated 4 days ago
    Auto-check passed
  • Arxiv Search

    WILLOSCAR/research-units-pipeline-skills

    Retrieve arXiv paper metadata with keyword queries or import an offline arXiv export, and save results as JSONL (papers/papersraw.jsonl).

    513 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Chapter Lead Writer

    WILLOSCAR/research-units-pipeline-skills

    Write H2 chapter lead blocks (sections/S<secidlead.md) that preview the chapter's comparison lens and connect its H3 subsections, without adding new facts.

    513 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Chapter Skeleton

    WILLOSCAR/research-units-pipeline-skills

    Build a retrieval-informed chapter skeleton (outline/chapterskeleton.yml) from taxonomy/core scope before stable H3 decomposition.

    513 GitHub stars~475 tokensUpdated 4 days ago
    Auto-check passed
  • Dedupe Rank

    WILLOSCAR/research-units-pipeline-skills

    A skill your agent uses when a broad paper candidate pool needs deterministic deduplication and a stable core set.

    513 GitHub stars~438 tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Outline Refiner

What does Outline Refiner do?

Planner-pass coverage + redundancy report for an outline+mapping, producing outline/coveragereport.md and outline/outlinestate.jsonl. Outline Refiner is an agent skill from WILLOSCAR/research-units-pipeline-skills.jsonl.

When should I use Outline Refiner?

Outline Refiner fits situations like: tasks that involve Test coverage.

How do I install Outline Refiner in Claude Code?

Run `npx skills add WILLOSCAR/research-units-pipeline-skills --skill outline-refiner -a claude-code`. Or copy the skill folder (.codex/skills/outline-refiner in WILLOSCAR/research-units-pipeline-skills) into .claude/skills/outline-refiner in your project. Claude Code loads it when a task matches its description.

How do I install Outline Refiner in Codex?

Run `npx skills add WILLOSCAR/research-units-pipeline-skills --skill outline-refiner -a codex`. Or copy the skill folder (.codex/skills/outline-refiner in WILLOSCAR/research-units-pipeline-skills) into .agents/skills/outline-refiner in your project. Codex loads it when a task matches its description.

Can I use Outline Refiner 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 WILLOSCAR/research-units-pipeline-skills --skill outline-refiner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outline-refiner, .gemini/skills/outline-refiner, .github/skills/outline-refiner and .opencode/skills/outline-refiner in your project.

What does Outline Refiner need to run?

Going by SKILL.md and its folder, Outline Refiner needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Outline Refiner access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Outline Refiner 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Outline Refiner use?

No licence was found for Outline Refiner or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Outline Refiner use?

About 824 tokens (SKILL.md is roughly 3.3k 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 Outline Refiner?

Skills that share tags, products or a category with Outline Refiner: Requirements (rizsotto/Bear, 6.5k stars), Crap Analysis (ardalis/RiverBooks, 135 stars), Code Coverage (s3s-project/s3s, 311 stars) and Project Status (bactopia/bactopia, 522 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outline Refiner?

WILLOSCAR (a GitHub user) maintains it in WILLOSCAR/research-units-pipeline-skills, which has 513 GitHub stars. The repository holds 107 skills in this directory. The repository was last updated on October 5, 2026.

Source: WILLOSCAR/research-units-pipeline-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.