Agent skill

knowledge-review

[Research] Review knowledge artifacts for completeness, citation quality, confidence accuracy, and template compliance.

Stars 6
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/duc01226/EasyPlatform/tree/main/.claude/skills/knowledge-review

SKILL.md

[IMPORTANT] Use TaskCreate to break ALL work into small tasks BEFORE starting.

Prerequisites: MUST READ before executing:

Web Research Protocol — Structured web research: define search queries, validate source credibility, cross-reference claims across 3+ sources, track evidence provenance. MUST READ .claude/skills/shared/web-research-protocol.md for full protocol and checklists.

OOP & DRY Enforcement: MANDATORY IMPORTANT MUST — flag duplicated patterns that should be extracted to a base class, generic, or helper. Classes in the same group or suffix (ex *Entity, *Dto, *Service, etc...) MUST inherit a common base (even if empty now — enables future shared logic and child overrides). Verify project has code linting/analyzer configured for the stack.

Quick Summary

Goal: Review knowledge artifacts for quality, completeness, and protocol compliance.

Workflow:

  1. Read artifact — Load the knowledge report/course/strategy
  2. Template compliance — Verify all enforced sections present
  3. Citation audit — Check inline citations and source table
  4. Confidence check — Verify scores match evidence
  5. Output review — Summary with pass/warn/fail per check

Key Rules:

  • Every section from template must be present and non-empty
  • Every factual claim must have inline citation
  • Confidence scores must match evidence basis
  • READ-ONLY — do not modify the artifact

Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).

Knowledge Review

Review Checklist

1. Template Compliance

  • All enforced sections present
  • No sections are empty placeholders
  • Section order matches template

2. Citation Audit

  • Every factual claim has inline citation [N]
  • Every source in Sources table is referenced in text
  • No orphan citations
  • Sources table has: Title, URL, Author, Date, Tier

3. Confidence Accuracy

  • Per-finding confidence scores declared
  • Overall confidence declared
  • Scores match evidence basis (not inflated)
  • Findings <60% flagged prominently

4. Source Quality

  • Tier distribution appropriate (not all Tier 4)
  • At least 50% Tier 1-2 sources for key claims
  • Recency appropriate for topic type

5. Knowledge Gaps

  • Gaps section is present and honest
  • Known limitations declared
  • Suggestions for further research included

6. Cross-Validation

  • Key claims verified by 2+ sources
  • Discrepancies noted where sources conflict
  • Single-source claims marked as unverified

7. Actionability

  • Recommendations are concrete (not vague)
  • Next steps are evidence-based
  • Executive summary captures key findings

Output Format

markdown
## Knowledge Review Result

**Status:** PASS | WARN | FAIL
**Artifact:** {path}

### Checks (N/7 passed)

- [x] Template compliance
- [x] Citation audit
- [ ] Confidence accuracy — {issue}
- [ ] Source quality — {issue}
      ...

### Issues

- {specific issues found}

### Verdict

{APPROVED | REVISE | BLOCKED}

Round 2: Focused Re-Review (MANDATORY)

Protocol: .claude/skills/shared/double-round-trip-review-protocol.md

After completing Round 1 evaluation, execute a second full review round:

  1. Re-read the Round 1 verdict and checklist results
  2. Re-evaluate ALL checklist items — do NOT rely on Round 1 memory
  3. Challenge Round 1 PASS items: "Is this really PASS? Did I verify citations and confidence?"
  4. Focus on what Round 1 typically misses:
    • Citation accuracy (do sources actually say what's claimed?)
    • Confidence calibration (are percentages realistic?)
    • Knowledge gaps that weren't flagged
    • Template compliance shortcuts
  5. Update verdict if Round 2 found new issues
  6. Final verdict must incorporate findings from BOTH rounds

Closing Reminders

  • MUST break work into small todo tasks using TaskCreate BEFORE starting
  • MUST search codebase for 3+ similar patterns before creating new code
  • MUST cite file:line evidence for every claim (confidence >80% to act)
  • MUST add a final review todo task to verify work quality
  • MUST execute two review rounds (Round 1: understand, Round 2: catch missed issues) MANDATORY IMPORTANT MUST READ the following files before starting:
  • MUST READ .claude/skills/shared/web-research-protocol.md before starting

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results