agentleFS
atilladenizatilladeniz/Kubeli/.claude/skills/vet/SKILL.md

vet

Skill387 starsChanged 9 months agoMITView on GitHub

Run vet immediately after ANY logical unit of code changes. Do not batch your changes, do not wait to be asked to run vet, make sure you are proactive.

  • Installs packages

10 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use teach.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • GoogleSkill

    teach

    Teach the user a new skill or concept, within this workspace.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 1 is distinctive, and 6 are very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before running vet, determine the correct Python binary:

    line 34
  2. Very specific:

    Use whichever resolves (prefer python3).

    line 38
  3. Very specific:

    Run: opencode session list --format json to list recent sessions with their IDs and titles.

    line 65
  4. Very specific:

    Run: grep -rl "UNIQUE_MESSAGE" ~/.codex/sessions/ to find the matching session file.

    line 72
  5. Very specific:

    Run vet --help and look at the vet repo's readme for details about defining custom OpenAI-compatible models.

    line 93
  6. Very specific:

    If this happens, try updating them.

    line 107
  7. Very specific:

    Run vet --update-models to fetch the latest community model definitions from the remote registry without upgrading vet itself.

    line 111

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Vet

Run vet immediately after ANY logical unit of code changes. Do not batch changes, do not wait to be asked to run vet, make sure you are proactive.

Vet reviews git diffs and conversation history to find issues in code changes and conversation history. It is most effective when run frequently with conversation history, which helps it catch misunderstandings between what was requested and what was implemented. Despite this, vet is not a replacement for running tests.

Installation

Install vet using pip, pipx, or uv:

# Using pip
pip install verify-everything

# Using pipx
pipx install verify-everything

# Using uv
uv tool install verify-everything

# Verify installation:
vet --help

Running Vet

Standard Usage

Before running vet, determine the correct Python binary:

$(command -v python3 || command -v python)

Use whichever resolves (prefer python3). The examples below use python3, substitute python if that is what your system provides.

OpenCode:

vet "goal" --history-loader "python3 ~/.agents/skills/vet/scripts/export_opencode_session.py --session-id <ses_ID>"

Codex:

vet "goal" --history-loader "python3 ~/.codex/skills/vet/scripts/export_codex_session.py --session-file <path-to-session.jsonl>"

Claude Code:

vet "goal" --history-loader "python3 ~/.claude/skills/vet/scripts/export_claude_code_session.py --session-file <path-to-session.jsonl>"

Without Conversation History

vet "goal"

Finding Your Session

You should only search for sessions from your coding harness. If a user requests you use a different harness, they are likely referring to vet's agentic mode, not the session.

OpenCode: The --session-id argument requires a ses_... session ID. To find the current session ID:

  1. Run: opencode session list --format json to list recent sessions with their IDs and titles.
  2. Identify the current session from the list by matching the title or timestamp.
    • IMPORTANT: Verify the session you found matches the current conversation. If the title is ambiguous, compare timestamps or check multiple candidates.
  3. Pass the session ID as --session-id.

Codex: Session files are stored in ~/.codex/sessions/YYYY/MM/DD/. To find the correct session file:

  1. Find the most unique sentence / question / string in the current conversation.
  2. Run: grep -rl "UNIQUE_MESSAGE" ~/.codex/sessions/ to find the matching session file.
    • IMPORTANT: Verify the conversation you found matches the current conversation and that it is not another conversation with the same search string.
  3. Pass the matched file path as --session-file.

Claude Code: Session files are stored in ~/.claude/projects/<encoded-path>/. The encoded path replaces / with - (e.g. /home/user/myproject becomes -home-user-myproject). To find the correct session file:

  1. Find the most unique sentence / question / string in the current conversation.
  2. Run: grep -rl "UNIQUE_MESSAGE" ~/.claude/projects/ to find the matching session file.
    • IMPORTANT: Verify the conversation you found matches the current conversation and that it is not another conversation with the same search string.
  3. Pass the matched file path as --session-file.

NOTE: The examples in the standard usage section assume the user installed the vet skill at the user level, not the project level. Prior to trying to run vet, check if it was installed at the project level which should take precedence over the user level. If it is installed at the project level, ensure the history-loader option points to the correct location.

Interpreting Results

Vet analyzes the full git diff from the base commit. This may include changes from other agents or sessions working in the same repository. If vet reports issues that relate to changes you did not make in this session, disregard them, assuming they belong to another agent or the user.

Common Options

  • --base-commit REF: Git ref for diff base (default: HEAD)
  • --model MODEL: LLM to use (default: claude-opus-4-6)
  • --list-models: list all models that are supported by vet
    • Run vet --help and look at the vet repo's readme for details about defining custom OpenAI-compatible models.
  • --update-models: fetch the latest community model definitions from the remote registry and cache them locally. See "Updating the Model Registry" below for when to run this.
  • --confidence-threshold N: Minimum confidence 0.0-1.0 (default: 0.8)
  • --output-format FORMAT: Output as text, json, or github
  • --quiet: Suppress status messages and 'No issues found.'
  • --agentic: Mode that routes analysis through the locally installed Claude Code or Codex CLI instead of calling the API directly. Try this if vet fails due to missing API keys. This is slower so it is not the default, but it often results in higher precision issue identification. --model is forwarded to the harness but not validated by vet, as vet doesn't know which models each harness supports.
  • --agent-harness: The two options for this are codex and claude. Claude Code is the default.
  • --help: Show comprehensive list of options

Updating

The vet CLI, skill files, and export scripts can become outdated as agent harnesses and LLM APIs change.

If this happens, try updating them. Run which vet to determine how vet was installed and update accordingly. For the skill files, check which skill directories exist on disk and update them with the latest versions from https://github.com/imbue-ai/vet/tree/main/skills/vet.

Updating the Model Registry

Run vet --update-models to fetch the latest community model definitions from the remote registry without upgrading vet itself. This caches model definitions locally so they appear in --list-models and can be used with --model.

You should run vet --update-models when:

  • Vet reports an unknown or unrecognized model error.
  • vet --list-models does not show a model you or the user expects to be available.
  • The user explicitly asks you to update the model registry.

Additional Information

Additional information can be found in the vet repo:

https://github.com/imbue-ai/vet

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.