Skip to content

hashgraph-online/awesome-codex-plugins / plugins/boshu2/agentops/skills/review

review

Verified

Give advisory feedback on a plan, design or code change. Use when: asked for an opinion or a look-over, even informally. Not for acceptance; use Validate.

FileKindSize
SKILL.mdskill md8.6 KB
references/advice-or-acceptance.mdmarkdown2.7 KB
references/document-findings.mdmarkdown1.7 KB

references/document-findings.md

View on GitHub
# Document findings

Use this page when the subject is a plan, design, ADR, specification or skill
text rather than code. It narrows which document concerns count as findings;
every rule in [Review](../SKILL.md) still applies.

## Missing detail

An omission is a finding only when a competent implementer or validator could
not work it out from the subject, its references and the repository's
conventions. Judge it against what the subject's stage owes: an intent or
requirements draft is not missing the mechanics a later plan decides, and a
plan is complete once its implementer can act and its validator can judge
([Plan](../../plan/SKILL.md)). Show the problem before
proposing the fix; an attractive addition does not prove anything is missing.

## Where careful readers would diverge

Look for places where two careful implementers would act differently:

- two passages that cannot both hold when no source settles which governs;
- one term used for two things, or two terms for one;
- a reference to something never defined or since removed;
- a quantifier with no bound, such as "all callers" or "any failure";
- a list that could be examples or the complete set;
- a sentence that hides who acts;
- "after X" without saying whether X started, finished or was verified.

Vagueness that every implementer would resolve the same way is not a finding.

## Defects a source settles

When the text or a cited source fixes the answer, such as a wrong count, a
stale reference or a passage that conflicts with its declared owner or a
higher-precedence source, report the defect and its correction. Do not invent
an unlikely reading that turns it into an open question. Leave a choice open
only when no source decides it, and still give your recommendation.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall