Agent skill

Formal Methods Reconciler

by mizchi in mizchi/skills

A skill your agent uses when reconciling software specs, docs, tests, configs, code, logs, or incidents with formal methods.

No licenceAuto-check passed

Install Formal Methods Reconciler

skills CLI
$ npx skills add mizchi/skills --skill formal-methods-reconciler -a claude-code

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

GitHub CLI
$ gh skill install mizchi/skills formal-methods-reconciler --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/mizchi/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/formal-methods-reconciler .claude/skills/formal-methods-reconciler && 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
formal-methods-reconciler
GitHub stars
360
Token cost
~1.9k tokens
SKILL.md length
965 words
Files
13 (incl. references)
Skills in repo
69
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when reconciling software specs, docs, tests, configs, code, logs, or incidents with formal methods.

  • Works in 9 steps: Choose the source of truth. → Extract claims before choosing a tool. → Classify the shape of the question. → …
  • Reconciling software specs
  • SKILL.md covers Workflow, Reporting Discipline, LLM Role Boundary and Research-Informed Patterns, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Formal Methods Reconciler is an agent skill from mizchi/skills. Use when reconciling software specs, docs, tests, configs, code, logs, or incidents with formal methods. Helps Codex extract claims, decide whether docs or implementation are the source of truth, choose an appropriate tool such as Z3, Alloy, TLA+, P, Dafny, MoonBit prove, Lean, Rocq, Why3, Verus, CBMC, Tamarin, or ProVerif, build the smallest useful model, run or plan verifier checks, and translate SAT/UNSAT, traces, proof failures, or proof obligations into domain-language questions and regression guards.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including reference files (for example `README.md`, `SKILL-ja.md` and `agents/openai.yaml`).

The repository describes itself as: Agent skills by mizchi, distributed via APM.

When your agent uses it

  • Reconciling software specs
  • Incidents with formal methods

Example prompts

  • “/formal-methods-reconciler”

Workflow steps

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

  1. Choose the source of truth.
  2. Extract claims before choosing a tool.
  3. Classify the shape of the question.
  4. Select the smallest appropriate tool.
  5. Build the minimum model.
  6. Run verifier feedback loops.
  7. Reproduce the witness against the implementation.
  8. Translate results to domain language.
  9. Lock decisions.

What it can do on your machine

Read from SKILL.md and the folder at commit 62f5808. 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

    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

Formal Methods Reconciler loads about 1.9k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 134 tokens; SKILL.md has 965 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~134
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.3k

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

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

“Use this skill to turn a vague correctness concern into a small formal-methods check and a domain-readable decision record.”

— opening of SKILL.md by mizchi
name
formal-methods-reconciler

Read the full SKILL.md on GitHub

Files

SKILL.md and 12 other files (references) in formal-methods-reconciler of mizchi/skills.

  • SKILL.md
  • README.md
  • SKILL-ja.md
  • agents/openai.yaml
  • evals/eval.yaml
  • evals/ledger.yaml
  • evals/tasks/scenario-a-config-z3.yaml
  • evals/tasks/scenario-b-authz-alloy.yaml
  • evals/tasks/scenario-c-async-tla-p.yaml
  • references/domain-ledger.md
  • references/reference-implementations.md
  • references/research-patterns.md
  • references/tool-selection.md

Open the folder on GitHubat commit 62f5808

Compare with similar skills

Formal Methods Reconciler 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.

Formal Methods Reconciler compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formal Methods Reconciler this skillmizchi/skills360—~1.9kAutomated safety check: PassNone
Spec Writergarrytan/gstack136k—~14kAutomated safety check: NotesMIT
Specgarden-co/classic-jazz2.5k—~1.3kAutomated safety check: PassMIT
Spec Driven Workflowalirezarezvani/claude-skills28k—~3.9kAutomated safety check: PassMIT
Sparc Specruvnet/ruflo74k—~1.1kAutomated safety check: NotesMIT
Write A Specdifferent-ai/openwork24k—~3.3kAutomated safety check: PassCustom licence

Similar skills

  • Spec Writer

    garrytan/gstack

    Converts a vague idea into a precise, executable spec in five phases, files it as an issue and can start an agent on it in a fresh worktree.

    136k GitHub stars~14k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Spec

    garden-co/classic-jazz

    Implement features using Spec Driven Development (SDD) workflow.

    2.5k GitHub stars~1.3k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Spec Driven Workflow

    alirezarezvani/claude-skills

    A skill your agent uses when the user asks to write specs before code, define acceptance criteria, plan features before implementation, generate tests from specifications, or follow spec-first…

    28k GitHub stars~3.9k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Sparc Spec

    ruvnet/ruflo

    Run the SPARC Specification phase — gather requirements, define acceptance criteria, identify constraints, and store the spec in memory

    74k GitHub stars~1.1k tokensUpdated today
    Product & Project ManagementAuto-check: notes
  • Write A Spec

    different-ai/openwork

    Write or extend an E2E journey spec in evals/specs that proves a PR's change to a human reviewer.

    24k GitHub stars~3.3k tokensUpdated today
    Testing & QAAuto-check passed
  • To Spec

    vinvcn/mattpocock-skills-zh-CN

    把当前对话转成 spec 并发布到项目 issue tracker:不做访谈,只综合已经讨论的内容. An agent skill from vinvcn/mattpocock-skills-zh-CN.

    4.7k GitHub stars~441 tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed

More from mizchi/skills

All 69 skills in this repo
  • Publish Agent Skill

    mizchi/skills

    Package, publish, verify and update an agent skill through a Claude Code plugin marketplace, APM or the npx skills CLI.

    360 GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check passed
  • AI Index

    mizchi/skills

    Method and tooling for measuring how AI-generated a piece of prose reads, in Japanese or English.

    360 GitHub stars~3.6k tokensUpdated 8 days ago
    Auto-check passed
  • Cloudflare Deploy

    mizchi/skills

    Deploy applications and infrastructure to Cloudflare with the cf CLI and typed cloudflare.config.ts.

    360 GitHub stars~2.9k tokensUpdated 8 days ago
    Auto-check: notes
  • Review Image

    mizchi/skills

    Review screenshots or other images with OpenRouter vision models via bundled Deno scripts.

    360 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Post-generation safety checks for sqlc-gen-moonbit + Cloudflare D1.

    360 GitHub stars~995 tokensUpdated 8 days ago
    Auto-check passed
  • Apm Usage

    mizchi/skills

    Reference for APM (Agent Package Manager) — apm.yml syntax, install / uninstall / update commands, target detection, lockfile workflow.

    360 GitHub stars~1.9k tokensUpdated 8 days ago
    Auto-check passed

Questions about Formal Methods Reconciler

What does Formal Methods Reconciler do?

A skill your agent uses when reconciling software specs, docs, tests, configs, code, logs, or incidents with formal methods. Formal Methods Reconciler is an agent skill from mizchi/skills. Use when reconciling software specs, docs, tests, configs, code, logs, or incidents with formal methods.

When should I use Formal Methods Reconciler?

Formal Methods Reconciler fits situations like: reconciling software specs; incidents with formal methods.

How do I install Formal Methods Reconciler in Claude Code?

Run `npx skills add mizchi/skills --skill formal-methods-reconciler -a claude-code`. Or copy the skill folder (formal-methods-reconciler in mizchi/skills) into .claude/skills/formal-methods-reconciler in your project. Claude Code loads it when a task matches its description.

How do I install Formal Methods Reconciler in Codex?

Run `npx skills add mizchi/skills --skill formal-methods-reconciler -a codex`. Or copy the skill folder (formal-methods-reconciler in mizchi/skills) into .agents/skills/formal-methods-reconciler in your project. Codex loads it when a task matches its description.

Can I use Formal Methods Reconciler 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 mizchi/skills --skill formal-methods-reconciler -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/formal-methods-reconciler, .gemini/skills/formal-methods-reconciler, .github/skills/formal-methods-reconciler and .opencode/skills/formal-methods-reconciler in your project.

What does Formal Methods Reconciler need to run?

SKILL.md names no scripts, command-line tools or credentials: Formal Methods Reconciler is instructions for the agent only.

Does Formal Methods Reconciler 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 Formal Methods Reconciler 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 Formal Methods Reconciler use?

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

How many tokens does Formal Methods Reconciler use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Formal Methods Reconciler?

Skills that share tags, products or a category with Formal Methods Reconciler: Spec Writer (garrytan/gstack, 136k stars), Spec (garden-co/classic-jazz, 2.5k stars), Spec Driven Workflow (alirezarezvani/claude-skills, 28k stars) and Sparc Spec (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formal Methods Reconciler?

mizchi (a GitHub user) maintains it in mizchi/skills, which has 360 GitHub stars. The repository holds 69 skills in this directory. The repository was last updated on October 2, 2026.

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