hashgraph-online/awesome-codex-plugins / plugins/boshu2/agentops/skills/review
review
VerifiedGive 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.6 KB |
| references/advice-or-acceptance.md | markdown | 2.7 KB |
| references/document-findings.md | markdown | 1.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |