Agent Hygiene

The quality bar for any agent working on agent definitions, skills, commands, hooks, AGENTS.md or CLAUDE.md, in any repo and any harness. Use at session start, before editing a file under .claude/agents, agents/, .claude/commands or any SKILL.md, before handing work back, and whenever choosing which model tier (Haiku, Sonnet, Opus, Fable) or effort level a task deserves. Carries the estate guardrails, the agent-file contract the linter enforces, the verification line every hand-back ends with, and the routing rule for spending the top tier.

48 stars 6 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add frankxai/claude-skills-library

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add frankxai/claude-skills-library --skill agent-hygiene
Manual install
git clone --depth 1 https://github.com/frankxai/claude-skills-library.git /tmp/claude-skills-library
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills-library/free-skills/agent-hygiene ~/.claude/skills/agent-hygiene

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Agent hygiene

> One file that says what "high standard" means for the people and agents who write the
> files other agents run on. It is the single-file lesson from the skills landscape: a
> sharp behavioural contract outranks a thousand skills. Everything here is checkable.

## When to use this

Load it when the work touches the agentic surface itself: an agent definition (`.claude/agents/*.md`,
`agents/*.md`, `*/AGENT.md`), a skill (`SKILL.md`), a command (`.claude/commands/*.md`), a hook, a
settings or marketplace manifest, `AGENTS.md`, `CLAUDE.md`. Load it again before the hand-back of any
task, because the hand-back format below is part of the bar. Load it when deciding how much model to
spend on a task.

## The bar, in one screen

1. **Think before writing.** State assumptions. If two readings of the ask exist, present both; do not
   pick silently. Turn the ask into a verifiable target before touching a file.
2. **Verify before claiming.** Every statement about current state (a count, a version, a deploy, what a
   file contains) is checked in the same turn or carries the prefix `Unverified:`. Your confidence is not
   evidence; the command output is.
3. **One canonical copy.** A skill or agent lives in exactly one place. Repos install it; they do not
   fork it. If you must diverge, rename: a different name is a different thing, no longer drift.
4. **Surgical.** Touch only what the task requires. Match the surrounding style. Name unrelated rot;
Read the full skill on GitHub

Details

Skill name
agent-hygiene
Path
free-skills/agent-hygiene/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Agent Hygiene skill do?

The quality bar for any agent working on agent definitions, skills, commands, hooks, AGENTS.md or CLAUDE.md, in any repo and any harness. Use at session start, before editing a file under .claude/agents, agents/, .claude/commands or any SKILL.md, before handing work back, and whenever choosing which model tier (Haiku, Sonnet, Opus, Fable) or effort level a task deserves. Carries the estate guardrails, the agent-file contract the linter enforces, the verification line every hand-back ends with, and the routing rule for spending the top tier.

How do I install the Agent Hygiene skill?

Claude Code plugin: /plugin marketplace add frankxai/claude-skills-library. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Hygiene popular?

It lives in frankxai/claude-skills-library, which has 48 GitHub stars and 6 forks.

Related skills

Acos Meta

48

frankxai/claude-skills-library

ACOS self-description and configuration skill. Documents how ACOS works, how to extend it, how to add new skills/commands/agents, and how to debug the hook system. Use when building new ACOS capabilities, understanding the system architecture, or onboarding to ACOS for the first time.

Software Development

Acos Visual Gen

48

frankxai/claude-skills-library

Generate research-grounded visuals using the InfoGenius pipeline. Use when creating infographics, diagrams, educational visuals, or any image that benefits from factual accuracy. Supports 8 visual styles (3D, technical, minimalist, photorealistic, futuristic, vintage, cartoon, standard) and 4 audience levels.

Images, Video & Audio

Agent Harness Construction

48

frankxai/claude-skills-library

Shape an agent's tools, observations, and recovery without adding a second coordinator. Use when defining a tool, a skill, a hook, or a worktree lane.

AI, LLMs & Agents

Agentic Jujutsu

48

frankxai/claude-skills-library

Quantum-resistant, self-learning version control for AI agents, with ReasoningBank intelligence and multi-agent coordination. Use when designing agent memory/versioning, coordinating multiple agents over shared state, or building experience-replay and learning loops into an agentic system.

AI, LLMs & Agents

Agentic Orchestration

48

frankxai/claude-skills-library

Patterns for multi-agent coordination, task decomposition, handoffs, and workflow orchestration. Best practices for building and managing agent systems. Use when designing how multiple agents coordinate — splitting up tasks, defining handoffs, or choosing an orchestration topology.

AI, LLMs & Agents

Upstash Vector Db Skills

23

gocallum/nextjs16-agent-skills

Upstash Vector DB setup, semantic search, namespaces, and embedding models (MixBread preferred). Use when building vector search features on Vercel.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.