agentsclimarketplace

Agent hygiene

Skill yltw27/agent-hygiene/skills/agent-hygiene

A local-first coding-agent hygiene skill that audits installed skills, tool setup, and usage signals to help reduce context noise and keep agent workflows focused.

Install
npx -y skills add yltw27/agent-hygiene --skill agent-hygiene

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Explicit-only audit of local coding-agent setup, installed skills, MCP servers, plugins, and recent usage signals. Use only when the user explicitly invokes $agent-hygiene.

SKILL.md

2.8 KB, as published. Nobody here has run it

Agent Hygiene

Invocation Policy

This skill must stay explicit-only. Keep agents/openai.yaml with policy.allow_implicit_invocation: false so the skill is not injected into normal sessions by default.

Do not edit, disable, unlink, uninstall, or remove anything during the audit unless the user explicitly asks for a follow-up cleanup step.

Scope

Audit the user's local coding-agent setup and recommend how to reduce context noise and tool-selection ambiguity.

Focus on:

  • Installed skills across Codex and common shared skill directories
  • Codex plugins and MCP servers
  • Duplicate or overlapping skills
  • Skills installed globally that should be project-local
  • Broad mandatory skills that may trigger too often
  • Explicit skill mentions and tool-call signals in recent Codex sessions
  • Skills with no visible recent use

Treat usage data as a signal, not proof. Implicit skill triggering may not be visible in logs, and old sessions may be compacted or absent.

Workflow

  1. Ask a clarifying question only if the user wants a non-default scope. Default to the last 30 days and the current machine.
  2. Run the bundled audit script from the skill directory:
python3 /path/to/agent-hygiene/scripts/audit_agent_hygiene.py --days 30
  1. Inspect the script output. Read specific SKILL.md files only when needed to verify broad descriptions, overlap, or agent-specific instructions.
  2. Produce recommendations. Do not run uninstall commands.

Recommendation Rubric

Use these categories:

  • Keep: recently used, narrow trigger, high-value workflow, or installed as part of an enabled plugin the user actively uses.
  • Move project-local: useful only in one repo or team context.
  • Make explicit-only: rare, broad, expensive, or potentially disruptive but still useful on demand.
  • Rewrite: useful skill with vague, overlapping, or "always/mandatory" trigger wording.
  • Remove: duplicate, stale, wrong-agent install, broken path, or no credible recent use.
  • Investigate: usage evidence is too thin to recommend confidently.

Prefer pruning global auto-triggerable skills before plugin or system skills. For plugin-provided skills, recommend disabling/removing the plugin only when the whole plugin appears unused.

Output

Return a concise audit:

  • Summary: counts and main risk.
  • Recommendations: grouped by action, with evidence.
  • Notes: limitations of the usage evidence.
  • Next command: one safe command to inspect or verify, not a destructive cleanup command.

Be direct. The goal is a smaller, higher-signal agent setup, not a complete inventory dump.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.