CtrlK
BlogDocsLog inGet started
Tessl Logo

doc-scanner

Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance. Auto-activates when user asks to review, understand, or explore a codebase, when starting work in a new project, when asking about conventions or agents, or when documentation context would help. Can consolidate multiple platform docs into unified AGENTS.md.

86

2.00x
Quality

Does it follow best practices?

Impact

98%

2.00x

Average score across 3 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, well-structured skill body that avoids concept-overlap padding. Its weaknesses are incomplete actionability (no executable glob/command examples), a destructive consolidation step lacking validation, and two reference files advertised in the body that are missing from the bundle.

Suggestions

Replace the plain filename block in Step 1 with an executable glob pattern (e.g. `Glob: **/{AGENTS,CLAUDE,GEMINI,...}.md`) so the scan is copy-paste ready.

Add a validation/confirmation checkpoint to the consolidation step (Step 4) — e.g. confirm the archive succeeded and verify no content was lost before generating the unified AGENTS.md — to satisfy the destructive-operation feedback-loop requirement.

Either create the referenced ./references/file-patterns.md and ./references/templates.md files or remove the 'Additional Resources' references, so the body does not advertise bundle files that are absent.

DimensionReasoningScore

Conciseness

The body is lean — short labeled steps, a synthesis template, and a priority list — with no explanation of concepts Claude already knows and no padding.

3 / 3

Actionability

It provides a synthesis output template and a consolidation procedure, but Step 1 lists filenames in a plain code block with no executable glob pattern or command, and Step 2 ('Read complete contents of every documentation file found') is a vague instruction rather than copy-paste-ready guidance.

2 / 3

Workflow Clarity

Five sequenced steps plus a no-documentation branch are clear, but Step 4 is a destructive/batch operation (archiving originals, generating a unified AGENTS.md) with no validation checkpoint or verify-before-overwrite feedback loop, which caps this dimension at 2.

2 / 3

Progressive Disclosure

Sections are well organized and an 'Additional Resources' section points one level deep to ./references/file-patterns.md and ./references/templates.md, but those referenced files do not exist (no references/ bundle), so the navigation advertised by the skill is broken.

2 / 3

Total

9

/

12

Passed

Description

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description with explicit 'when to use' triggers and concrete actions. Its main weakness is trigger breadth — 'review/understand/explore a codebase' is generic enough to risk overlapping with other exploration-oriented skills.

Suggestions

Tie the triggers more tightly to documentation specifically (e.g. 'Use when the user wants to find or consolidate AI-assistant/IDE config docs in a project') to reduce overlap with general codebase-exploration skills.

Lead with the most distinctive capability ('consolidates multiple platform docs into a unified AGENTS.md') earlier in the description so the niche is immediately clear.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Scans for project documentation files', 'synthesizes guidance', 'Can consolidate multiple platform docs into unified AGENTS.md' — each tied to named artifacts.

3 / 3

Completeness

Explicitly answers both what (scan/synthesize/consolidate docs) and when ('Auto-activates when user asks to review, understand, or explore a codebase'), satisfying the explicit-trigger requirement.

3 / 3

Trigger Term Quality

Covers natural user phrasings — 'review, understand, or explore a codebase', 'starting work in a new project', 'asking about conventions or agents' — that a user would actually say.

3 / 3

Distinctiveness Conflict Risk

The documentation/AGENTS.md niche is reasonably clear, but the broad triggers 'review, understand, or explore a codebase' overlap with general exploration skills, so it is not yet a distinct, conflict-free niche.

2 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.