CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-curator

Orchestrate research entry lifecycle in ./research/ — create, batch-import, refresh stale entries, and validate structure. Use when asked to add a tool, research a URL, document a library, refresh research, validate entries, or given any tool or library URL. Supports --batch (parallel multi-URL), --rerun (refresh one or all entries), and --validate (structural check with auto-fix of error-severity issues).

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

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

This is a highly actionable, well-validated orchestrator skill: exact commands, verbatim handoff prompts, authoritative flow diagrams, and feedback loops with stop conditions covering every mode. Its main cost is length — repetitive restatement of shared rules and rationale prose inflate the body — and one dangling non-bundle path pointer.

Suggestions

State the "marked with issues → README row withheld, still committed" rule once (in Post-Actions or the Validation Gate section) and reference it from Default, Batch, Rerun, Entry Review, and Output Format instead of restating it in each place.

Trim rationale paragraphs (e.g., why --untracked-files=all is required, why backlink repair precedes review) to one-line operational rules; the instruction stands without the supporting argument.

Move the full Entry Review and Post-Actions procedures into references/ files (as Batch Mode already does) and keep a spine in SKILL.md; also drop or fix the pointer to rules/commit-cadence-and-worktrees.md, which does not exist in the bundle.

DimensionReasoningScore

Conciseness

Nearly all of the 623-line body is non-obvious operational rule rather than concepts Claude already knows, but it is noticeably padded: multi-sentence rationale paragraphs (the --untracked-files=all justification, the repair-reciprocity argument) and rules restated across sections (the "marked with issues → README row withheld" rule appears in Default, Batch, Entry Review, Post-Actions, and Output Format). This fits the "mostly efficient but includes some unnecessary explanation or could be tightened" anchor; not level 2 because the bulk is genuinely load-bearing edge-case handling for a complex orchestrator.

3 / 5

Actionability

The body supplies copy-paste bash (baseline capture, uv run --script invocations, path-scoped git commit), verbatim reviewer/worker prompt templates, and executable mermaid procedures marked authoritative. This matches the fully executable, copy-paste-ready anchor; the brace placeholders are per-invocation resolved values, not missing detail.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints throughout: a Validation Gate after every write, a reviewer→worker→reviewer loop with a 5-round cap and no-progress stop condition, four ordered backlink-failure result cases with exit-code handling, and Failure Recovery routing. This is the anchor case for clear sequence, explicit validation, feedback loops, and checklists for complex batch/destructive operations.

5 / 5

Progressive Disclosure

Structure is good: every markdown link resolves one level deep to a real references/ file (batch-mode, validation-rules, entry-review-rubric, overlap-scan, duplicate-detection), and bulk detail is offloaded from the body. Held below 5 because the inlined Post-Actions and Entry Review prose is long enough that it could be split like batch-mode.md, and the inline pointer to rules/commit-cadence-and-worktrees.md references a file that does not exist in this bundle. Not level 3: references are clearly signaled and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

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 description: it states the full lifecycle capability set in third person, includes an explicit "Use when" clause with six concrete trigger phrases, and documents the three mode flags. Its only weaknesses are minor — a few missing natural synonyms and slight overlap risk between "research a URL"-style triggers and general research requests.

DimensionReasoningScore

Specificity

The description enumerates the full lifecycle concretely — "create, batch-import, refresh stale entries, and validate structure" — plus three concrete modes (--batch, --rerun, --validate with auto-fix of error-severity issues). This matches the anchor for multiple specific concrete actions with comprehensive coverage; the level-4 anchor requires a coverage gap that is not present.

5 / 5

Completeness

It explicitly answers both what ("Orchestrate research entry lifecycle in ./research/ — create, batch-import, refresh stale entries, and validate structure") and when ("Use when asked to... or given any tool or library URL") with six concrete trigger phrases, matching the anchor that requires both what and when with concrete trigger phrases. Not level 4, where the when clause would be less explicit or specific.

5 / 5

Trigger Term Quality

"Use when asked to add a tool, research a URL, document a library, refresh research, validate entries, or given any tool or library URL" provides good natural-phrase coverage, but misses common variations a user might say (e.g., "update research", "check entries"). This fits the anchor for good keyword coverage with a few natural terms missing rather than the comprehensive synonym coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

The ./research/ vault-lifecycle scope and mode-specific flags give it a clear niche, but phrases like "research a URL" or "document a library" could plausibly trigger for general web-research or documentation requests — a minor overlap risk with closely related skills. Not level 5 because of that overlap; not level 3 because the scope keeps it well distinguished from generic skills.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (624 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

Jamie-BitFlight/claude_skills

Path

.claude/skills/research-curator/SKILL.md

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.