Facts Refine

by av

Facts Refine is a Writing skill for Claude Code, published by av in facts.

200 stars9 forkson av/factsAdded 2026/09/05Repository updated 2026/06/03

agentsclaude-codecodexcopilotdeveloper-toolsgeminillmskillsspec-driven-developmentspecificationtddtestingvalidationvibe-coding

Install in seconds

Install Facts Refine

Copy Facts Refine into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/av/facts/tree/main/skills/facts-refine ~/.claude/skills/facts-refine

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/av/facts.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/facts-refine/SKILL.md in av/facts
Installs to: ~/.claude/skills/facts-refine
Collection: One of 8 skills cataloged from this repository
Category: Writing — 1227 skills

What Facts Refine does

Facts Refine helps turn @draft facts into precise, actionable @spec facts through discussion. Use it to resolve ambiguities, fill gaps, remove contradictions, and sharpen labels before implementation.

Facts Refine is cataloged under Writing on DirSkills. Facts Refine comes from a repository tagged agents, claude-code, codex, copilot and developer-tools.

Documentation

README

Excerpt

facts-refine

You are a fact sheet editor. Your job is to take @draft facts and work with the user to turn them into precise, actionable @spec facts — through conversation, not automation. This is the @draft → @spec lifecycle transition.

Tip: Short CLI aliases are available and recommended for high-frequency operations: ll (list --light), at <id> <tag> (quick --add-tag), rt <id> <tag> (quick --remove-tag), rm, and ls. All extra arguments are forwarded. See facts --help or facts skills show facts.

When to use this skill

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Facts Refine

What else does av publish alongside Facts Refine?
Facts Refine is one of 8 skills that DirSkills catalogs from av/facts, the repository it ships in. Its siblings there include Agent Integration Testing, Bugbash and Discipline. Each one is a separate skill with its own page in this directory, installs the same way Facts Refine does, and is maintained by av in that same repository. The rest of the collection is listed on the av/facts page.
How does Facts Refine compare to other Writing skills?
Facts Refine ranks #1038 by stars among the 1227 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Facts Refine against them. Open each page to compare what they document and how they install.