Content
39%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill has a well-structured workflow with good validation checkpoints and user approval gates, but is severely bloated with information Claude already knows (source evaluation, query construction, handling ambiguity). The content would benefit enormously from being split into a concise SKILL.md overview with supporting reference files, and from removing explanations of concepts that are basic knowledge for an LLM.
Suggestions
Cut at least 50% of the content by removing sections Claude already knows: source evaluation hierarchy, good vs poor query examples, handling ambiguity guidelines, and the limitations section. These are general reasoning skills, not task-specific knowledge.
Extract 'Search best practices,' 'Special considerations,' and 'Examples' into separate reference files (e.g., SEARCH_GUIDE.md, EXAMPLES.md) and link from the main SKILL.md to improve progressive disclosure.
Add concrete tool invocation syntax for the web search step — show the actual search tool call format rather than just describing what to search for.
Remove the 'Next Step: Export Verified Content' section which cross-promotes other skills and adds no value to the fact-checking workflow itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250 lines. It explains obvious concepts like what constitutes 'good queries' vs 'poor queries,' how to evaluate sources (Claude already knows this), and includes lengthy sections on handling ambiguity, numerical precision, and limitations that Claude inherently understands. The 'When to use' trigger phrases, subjective content skip list, and source evaluation hierarchy are all things Claude already knows. Many sections could be cut by 70%+. | 1 / 3 |
Actionability | The workflow steps are reasonably concrete with a comparison table format, status codes, and a report template. The Edit tool example is executable. However, much of the guidance is procedural description rather than executable code — the search strategy is descriptive, the examples are process summaries rather than concrete demonstrations, and there's no actual search tool invocation syntax shown. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced with 5 explicit steps, a progress checklist, and critical validation checkpoints — particularly the explicit 'wait for user approval before making changes' gate in Step 5, post-edit verification, and a quality checklist at the end. The feedback loop of showing the report and waiting for confirmation before destructive edits is well-handled. | 3 / 3 |
Progressive Disclosure | The entire skill is a monolithic wall of text with no references to supporting files. Content like the detailed source evaluation guidelines, search best practices, special considerations, and examples could easily be split into separate reference files. Everything is inline, making the skill unnecessarily long for the SKILL.md overview level. | 1 / 3 |
Total | 7 / 12 Passed |