encero-systems/incan / .agents/skills/review-rust-prose
review-rust-prose
VerifiedReview touched Rust files for prose-comment quality, rustdoc accuracy, and manually chopped comment wrapping. Use when a broad review needs a dedicated Rust prose/rustdoc pass or when the user asks for comment-quality review specifically.
Review Rust Prose — Incan Compiler
Purpose
/review-rust-prose is a narrow report-only reviewer for touched .rs files that contain ///, //!, or prose //.
Own:
- rustdoc paragraph shape
- manually chopped comment wrapping
- touched doc/comment accuracy against current behavior
- public/non-trivial documentation coverage in touched Rust code
Do not own:
- test style
- docs-site markdown
- architectural placement
- final branch-clean judgment
Output artifact
Write a slice report at:
.agents/state/review-report.rust-prose.md
Do not write to the canonical .agents/state/review-report.md.
Workflow
- Review only the touched
.rsfiles assigned by the orchestrator. If no slice was assigned, limit yourself to touched.rsfiles with prose comments. - For each file, inspect touched prose blocks directly. Do not infer prose quality from broad code reading.
- Flag:
- clause-by-clause or narrow-column manual wrapping
- fake paragraph breaks
- stale or misleading rustdoc
- missing touched public/non-trivial docs that should exist
- Treat the accepted shape as:
- natural paragraph prose, then
make fmtwrapping - or multiple paragraphs separated for a real semantic break
- natural paragraph prose, then
- Record only Rust prose/documentation findings for this slice.
Slice report shape
Keep slice reports findings-first. Do not enumerate every clean file with a full checklist. Only record:
- actual findings,
- and, optionally, a short
## Reviewed Clean Surfacessection for risky or non-obvious clean calls.
# Review Slice Report
- role: rust-prose
- worker: <agent-id or stable label>
- status: in_progress | clean | blocked
## Scope
- assigned files:
- src/foo.rs
## Findings
- [ ] warning | rustdoc prose | src/foo.rs:42
Manually chopped single-paragraph rustdoc.
## Reviewed Clean Surfaces
- src/bar.rs — rust prose reviewed; no findings
Only include ## Reviewed Clean Surfaces when the clean call matters to the orchestrator, such as:
- touched
.rsfiles with prose comments, - files that are likely to be checked by another reviewer,
- or surfaces involved in disagreement resolution.
If there are no findings, say so explicitly.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |