CtrlK
BlogDocsLog inGet started
Tessl Logo

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).

69

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.

A highly actionable, well-validated orchestration skill with authoritative flowcharts, exact commands, and verified one-level-deep references. Its main weakness is conciseness: several sections justify decisions in prose and restate rules already encoded in mode flows, which inflates the token budget without adding instruction value.

Suggestions

Move the rationale prose in Entry Review and Post-Actions (e.g. why 'none' answers matter, why repair runs before review, why --exclude is needed) into a reference file or compress to one-line imperatives, keeping only the instruction itself in SKILL.md.

Deduplicate the README-update gating: Post-Actions step 1 restates in ~30 lines what Default step 6d, Batch, and Rerun modes already specify — replace with a short pointer plus only the novel rules (row restoration via git show HEAD, withholding rows for issue-marked entries).

Consider moving the Agent Result Relay Rules tables into a referenced file loaded by the modes that relay agent output, shortening the always-loaded body.

DimensionReasoningScore

Conciseness

The body is dense with genuinely load-bearing orchestration detail, but it repeatedly explains why rather than instruct — e.g. the Entry Review paragraphs "the paths carry a date the agent cannot derive... a blank line costs three gates", the repair-reciprocity justification, and the ~30-line prose note in Post-Actions step 1 that restates README gating each mode already specifies. It fits anchor 3 (mostly efficient but includes some unnecessary explanation or could be tightened): above anchor 2's pervasive padding, but the rationale passages and duplicated gating restatements keep it below anchor 4's minor-trim level.

3 / 5

Actionability

Guidance is fully executable: exact Agent tool parameter blocks (agent path + prompt text), copy-paste bash commands (uv run validate_research.py, run_bounded.py with --timeout-seconds 180, git commit with explicit path arguments), literal output-format templates, and a specified result-checking order (exit 124 → JSON shape → stderr → continue). This matches the level-5 anchor: copy-paste-ready commands covering the common cases, clearly above level 4's "minor gaps".

5 / 5

Workflow Clarity

Multi-step processes are sequenced via authoritative Mermaid flowcharts with explicit conditions, branches, and terminal states; batch operations have validation gates with --fix retry loops, and Post-Actions defines a four-case error-recovery check with halt conditions (timeout, malformed JSON, io-error). This matches the level-5 anchor (explicit validation steps, feedback loops for error recovery, checklists for complex processes); the batch-validation cap is not triggered since validation is pervasive.

5 / 5

Progressive Disclosure

References are one level deep and well signaled — duplicate-detection.md, validation-rules.md (section anchor), batch-mode.md, entry-review-rubric.md, and integration-opportunity-search.md, all verified present in ./references/, with load-only-when-needed guidance ("Load it only when redesigning that search"). This is good structure at anchor 4 rather than 5 because some content that could live in a reference is inlined in the ~520-line body (the Agent Result Relay Rules tables and the long Entry Review prose), which the level-5 anchor would keep as a lean overview pointing to split-out files.

4 / 5

Total

17

/

20

Passed

Description

92%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: third-person voice, explicit what-and-when, concrete mode flags, and natural trigger phrases scoped to a distinct niche. The only minor gap is that a few plausible user synonyms for the trigger terms are not covered.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific actions — "create, batch-import, refresh stale entries, and validate structure" — and further concretizes each mode flag: "--batch (parallel multi-URL)", "--rerun (refresh one or all entries)", "--validate (structural check with auto-fix of error-severity issues)". This matches the level-5 anchor (multiple specific concrete actions, comprehensive coverage) and exceeds level 4, which anticipates gaps in coverage; every mode of the skill is named with its exact flag semantics.

5 / 5

Completeness

Both questions are answered explicitly and concretely: what — "Orchestrate research entry lifecycle in ./research/ — create, batch-import, refresh stale entries, and validate structure"; when — a full "Use when asked to..." clause enumerating six concrete trigger phrases. This matches the level-5 good_overall_example pattern exactly; level 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

The "Use when asked to add a tool, research a URL, document a library, refresh research, validate entries, or given any tool or library URL" clause covers the natural phrasings a user would plausibly say. It sits between anchors 4 and 5: good keyword coverage but a few natural synonyms/variants are missing (e.g. "look up a library", "check research entries", "update an entry"), so it does not reach the comprehensive-with-synonyms level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche — the "./research/" entry vault and its lifecycle — with distinct triggers ("add a tool", "research a URL", "refresh research", "validate entries") and mode flags that no generic research or documentation skill would share. Minimal conflict risk; matches the level-5 clear-niche anchor.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository
Jamie-BitFlight/claude_skills
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.