Adonis0123/adonis-skills / skills/agent-practice-audit
agent-practice-audit
FlaggedScore how someone uses coding agents (Claude Code, Codex, Grok and WorkBuddy session logs, instruction files, hooks, permissions, Codex config) against practices quoted from official vendor docs, and write a local HTML report with coverage, trend and suggestions; also refresh or verify that practice list from official docs with multi-model consensus. Use when the user asks how far their agent usage is from official practice, wants an agent usage check-up or grade, or wants the practice list refreshed, its links checked, or either run on a schedule. Chinese triggers: Agent 用法体检、对照官方最佳实践、我的 agent 用得对不对、给 agent 用法打分、更新最佳实践清单. Not for whether a tool, MCP or skill is worth keeping (dev-environment-roi-audit), for writing or reviewing one CLAUDE.md or AGENTS.md, for general best-practice questions, or for Cursor or Gemini CLI logs, which it does not read. Never edits the user's config.
references/sources/cc-art-steering.md
View on GitHub---
slug: cc-art-steering
title: Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents
publisher: Anthropic
url: https://claude.com/resources/articles/steering-claude-code-skills-hooks-rules-subagents-and-more
fetchedAt: 2026-11-11
lastVerifiedAt: 2026-11-11
linkStatus: ok
finalUrl:
---
# Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents
## Summary
- Compares seven ways to steer Claude Code: root and subdirectory `CLAUDE.md`, rules, skills, subagents, hooks, output styles and appended system prompts.
- Each differs in when it loads, whether it survives compaction, its context cost and how much authority it carries.
- Keep `CLAUDE.md` under about 200 lines, owned and reviewed like code; it should be an index and hold build commands and conventions.
- Scope rules with `paths:` so they load only when matching files are touched; an unscoped rule costs the same as `CLAUDE.md`.
- Procedures such as deploy or review checklists belong in skills, which load their body only when invoked.
- Use subagents for side tasks whose intermediate output would clutter the main thread; only the final message returns.
- Use hooks for anything that must happen deterministically, such as linting after edits or blocking commands; prompted "never" rules can fail under pressure.
- Prefer built-in output styles; a custom one replaces default coding instructions unless told to keep them.
- Keep personal preferences in user-level files and team-wide ones in project files.
## Cited quotes
- "Use hooks for anything that should happen deterministically: running linters after edits, posting to Slack on completion, or blocking specific commands before they execute." (verify-lint-hook)
- "A real guardrail needs to be deterministic, and the enforcement methods are hooks and permissions." (safe-hooks-for-musts)
- "A 30-line procedure in CLAUDE.md. Procedures belong in skills." (doc-skills-on-demand)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |