Agent skill

Caveats And Status

by ccplugins in ccplugins/awesome-claude-code-plugins

A skill your agent uses 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.

Apache-2.0Auto-check passed

Install Caveats And Status

skills CLI
$ npx skills add ccplugins/awesome-claude-code-plugins --skill caveats-and-status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ccplugins/awesome-claude-code-plugins caveats-and-status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/craftsman/skills/caveats-and-status .claude/skills/caveats-and-status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
caveats-and-status
GitHub stars
968
Token cost
~513 tokens
SKILL.md length
251 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses 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.

  • About to report any nontrivial task as complete — requires closing with a Caveats & status section stating what was verified
  • SKILL.md covers Overview, When this applies, The format and Rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • What was assumed

What it does

Caveats And Status is an agent skill from ccplugins/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.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Awesome Claude Code plugins — a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code. The licence is Apache-2.0.

When your agent uses it

  • About to report any nontrivial task as complete — requires closing with a Caveats & status section stating what was verified
  • What was assumed
  • Whats unresolved

Example prompts

  • “/caveats-and-status”

What it can do on your machine

Read from SKILL.md and the folder at commit 5bd4f16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Caveats And Status loads about 513 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 251 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~513

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ccplugins/awesome-claude-code-plugins at commit 5bd4f16, republished under its Apache-2.0 licence (© ccplugins). 251 words, ~513 tokens.

Download SKILL.mdSave it as .claude/skills/caveats-and-status/SKILL.md (or your agent's skills folder).
name
caveats-and-status
description
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.

Caveats & Status

Overview

"Done" without a status check is a guess wearing a confident voice. This skill defines the closing format every nontrivial completed task uses, so what wasn't verified is always visible rather than buried in an upbeat summary.

Core principle: state what you checked, not just what you did.

When this applies

Any response that reports a task as complete, fixed, or passing — code changes, file scaffolding, investigations with a conclusion. Skip it for pure Q&A with no action taken, and for the quick flow's trivial one-liners where the verification step itself already says everything needed (don't pad a two-line change with a boilerplate section that adds nothing).

The format

End the response with:

**Caveats & status**
- Verified: <what you actually ran/observed, with the result>
- Assumed: <anything taken on faith because it couldn't be checked here>
- Not covered: <what's explicitly out of scope or unverified>

Omit a line entirely if it's genuinely empty (e.g. "Assumed: none" is fine to state plainly, but don't stretch to fill a line that has nothing real to say).

Rules

  • "Verified" requires a command actually run or a behavior actually observed in this session — not "should work," not a previous run, not extrapolation from a partial check.
  • If verification wasn't possible (no test environment, no way to run the app), say so explicitly in "Not covered" rather than silently omitting it — an honest gap beats an implied guarantee.
  • Run the verification and read its actual output before writing the "Verified" line — the claim comes after the evidence, never before. Report failures honestly, with the actual error output, not a softened summary. This format stands alone; it does not depend on any other plugin being installed.

© ccplugins, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/craftsman/skills/caveats-and-status of ccplugins/awesome-claude-code-plugins.

Open the folder on GitHubat commit 5bd4f16

Compare with similar skills

Caveats And Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Caveats And Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Caveats And Status this skillccplugins/awesome-claude-code-plugins968—~513Automated safety check: PassApache-2.0
HTML Ppt Zhangzara Pin And Papernexu-io/open-design100k—~1.3kAutomated safety check: PassMIT
Search Fallback WorkflowHKUDS/OpenSpace7.7k—~1.2kAutomated safety check: PassMIT
TAM SAM SOM Calculatordeanpeters/Product-Manager-Skills7.2k1 repos~4.8kAutomated safety check: PassCustom licence
Skill Verifynyldn/claude-octopus4.2k1 repos~1.4kAutomated safety check: PassMIT
H Notem0n0x41d/haft1.4k—~309Automated safety check: PassCustom licence

Similar skills

  • A field-biology capstone on urban pollinator decline — the survey design, the data, the contribution, and the caveats.

    100k GitHub stars~1.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Graceful degradation workflow for continuing tasks when web search tools fail, using internal knowledge with verification caveats

    7.7k GitHub stars~1.2k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • TAM SAM SOM Calculator

    deanpeters/Product-Manager-Skills

    Calculates total, serviceable available and serviceable obtainable market size for a product idea with explicit assumptions, methods and caveats.

    7.2k GitHub starsUsed in 1 repo~4.8k tokens
    Product & Project ManagementAuto-check passed
  • Skill Verify

    nyldn/claude-octopus

    A skill your agent uses when a nontrivial change needs end-to-end verification before committing or shipping

    4.2k GitHub starsUsed in 1 repo~1.4k tokens
    Testing & QAAuto-check passed
  • H Note

    m0n0x41d/haft

    Persist an explicitly requested non-binding fact, observation, caveat, or small rationale in Haft project memory.

    1.4k GitHub stars~309 tokensUpdated 10 days ago
    Agent WorkflowsAuto-check passed
  • H Note

    m0n0x41d/haft

    Persist a fact, observation, caveat, or small non-binding rationale in Haft project memory when the operator explicitly asks or current Work supplies a concrete operator-named or agent-inferred…

    1.4k GitHub stars~1.1k tokensUpdated 10 days ago
    Agent WorkflowsAuto-check: notes

More from ccplugins/awesome-claude-code-plugins

All 66 skills in this repo
  • AI Meeting

    ccplugins/awesome-claude-code-plugins

    Run structured AI meetings for plans, product ideas, technical designs, business decisions, feature proposals, and strategy choices.

    968 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Fastapi App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new FastAPI backend with async SQLAlchemy 2.0, asyncpg, Alembic, Pydantic v2, and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Flutter App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Nextjs App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Next.js (App Router, TypeScript) web app with current packages and no deprecated APIs.

    968 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dev Report

    ccplugins/awesome-claude-code-plugins

    Write up a coding session for a non-technical stakeholder — the context, what was built, and the engineering reasoning behind it — the way a senior engineer briefs a product manager who does not…

    968 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Difesa Attacchi

    ccplugins/awesome-claude-code-plugins

    Aggiunge a un sito/app un agente di difesa che rileva e blocca richieste malevole (SQL injection, XSS, path traversal, brute force, bot) con rate limiting, blocklist IP e modalità lockdown che…

    968 GitHub stars~781 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Caveats And Status

What does Caveats And Status do?

A skill your agent uses 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. Caveats And Status is an agent skill from ccplugins/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.

When should I use Caveats And Status?

Caveats And Status fits situations like: about to report any nontrivial task as complete — requires closing with a Caveats & status section stating what was verified; what was assumed; whats unresolved.

How do I install Caveats And Status in Claude Code?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill caveats-and-status -a claude-code`. Or copy the skill folder (plugins/craftsman/skills/caveats-and-status in ccplugins/awesome-claude-code-plugins) into .claude/skills/caveats-and-status in your project. Claude Code loads it when a task matches its description.

How do I install Caveats And Status in Codex?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill caveats-and-status -a codex`. Or copy the skill folder (plugins/craftsman/skills/caveats-and-status in ccplugins/awesome-claude-code-plugins) into .agents/skills/caveats-and-status in your project. Codex loads it when a task matches its description.

Can I use Caveats And Status in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ccplugins/awesome-claude-code-plugins --skill caveats-and-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/caveats-and-status, .gemini/skills/caveats-and-status, .github/skills/caveats-and-status and .opencode/skills/caveats-and-status in your project.

What does Caveats And Status need to run?

SKILL.md names no scripts, command-line tools or credentials: Caveats And Status is instructions for the agent only.

Does Caveats And Status access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Caveats And Status safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Caveats And Status use?

Caveats And Status is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Caveats And Status use?

About 513 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Caveats And Status?

Skills that share tags, products or a category with Caveats And Status: HTML Ppt Zhangzara Pin And Paper (nexu-io/open-design, 100k stars), Search Fallback Workflow (HKUDS/OpenSpace, 7.7k stars), TAM SAM SOM Calculator (deanpeters/Product-Manager-Skills, 7.2k stars) and Skill Verify (nyldn/claude-octopus, 4.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Caveats And Status?

ccplugins (a GitHub organization) maintains it in ccplugins/awesome-claude-code-plugins, which has 968 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on August 12, 2026.

Source: ccplugins/awesome-claude-code-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.