Skills for Real Engineers. Straight from my .agents directory.
caveats-and-status
Agent skill fromccplugins/awesome-claude-code-plugins
Use when about to report any nontrivial task as complete — requires closing with a Caveats & status section stating what was verified, what was assumed, and what's unresolved.
How to install caveats-and-status
npx skills add ccplugins/awesome-claude-code-plugins# or add only this skill to Claude Code: copy the folder
plugins/craftsman/skills/caveats-and-status/
# into
~/.claude/skills/caveats-and-status/ (all projects)
.claude/skills/caveats-and-status/ (one project)
1# Caveats & Status23## Overview45"Done" without a status check is a guess wearing a confident voice. This skill defines the closing6format every nontrivial completed task uses, so what wasn't verified is always visible rather than7buried in an upbeat summary.89**Core principle:** state what you checked, not just what you did.1011## When this applies1213Any response that reports a task as complete, fixed, or passing — code changes, file scaffolding,14investigations with a conclusion. Skip it for pure Q&A with no action taken, and for the `quick`15flow's trivial one-liners where the verification step itself already says everything needed (don't16pad a two-line change with a boilerplate section that adds nothing).1718## The format1920End the response with:2122```23**Caveats & status**24- Verified: <what you actually ran/observed, with the result>25- Assumed: <anything taken on faith because it couldn't be checked here>26- Not covered: <what's explicitly out of scope or unverified>27```2829Omit a line entirely if it's genuinely empty (e.g. "Assumed: none" is fine to state plainly, but30don't stretch to fill a line that has nothing real to say).3132## Rules3334- "Verified" requires a command actually run or a behavior actually observed in this session —35 not "should work," not a previous run, not extrapolation from a partial check.36- If verification wasn't possible (no test environment, no way to run the app), say so explicitly37…
Excerpt shown under the repository's Apache-2.0 license.
More skills in awesome-claude-code-plugins
Similar skill repositories
An agentic skills framework & software development methodology that works.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Production-grade engineering skills for AI coding agents.
