CtrlK
BlogDocsLog inGet started
Tessl Logo

triage-tool

Triage a tool or library into a structured reference summary for the research repo. Use when given a GitHub URL, npm package, PyPI package, or CLI tool name. Creates references/{slug}.md with architecture overview and scope assessment; adds REVIEWED.md entry and REFERENCE_INDEX.md row. Triggers: triage tool, add tool, analyse tool, GitHub project, npm package, PyPI package, library, framework, CLI tool, MCP server, open source project.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-structured, lean workflow skill: sequenced steps with confirmation gates, concrete commands, and exemplary progressive disclosure — every referenced bundle file (classification guide, three YAML templates, three schemas, two validators) exists exactly one level deep. The main defects are small: one Quick Commands path points to a non-existent `templates/REFERENCE-tool.md`, the duplicate-check is stated three times, and validation scripts are listed separately rather than wired into the workflow steps.

Suggestions

Fix the Quick Commands copy line: `cp templates/REFERENCE-tool.md references/<slug>.md` references a file that does not exist — the actual template is `assets/templates/REFERENCE-tool.yaml`, which step 5 correctly cites.

Wire the validators into the workflow: add 'run `./scripts/validate-reference-tool.sh references/<slug>.md`' as an explicit sub-step of step 5 (and the analysis validator to step 10) so validation is a checkpoint, not an aside in Quick Commands.

State the duplicate-check guidance once (Workflow step 2) and let the anti-pattern reference it, removing the repeated instruction in Quick Commands.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanation of concepts Claude already knows — steps like "Record: tool name, author/org, license, language, latest version/commit" and tight section bullets assume competence. Minor trimming opportunities remain: the duplicate-check instruction appears three times (Workflow step 2, Quick Commands, and an anti-pattern), and the trailing table-format comment in Quick Commands duplicates step 7. Not a 5 because of that small redundancy; well above the padded 3 anchor.

4 / 5

Actionability

Mostly executable guidance: concrete commands (`grep -i "<slug>" REVIEWED.md references/REFERENCE_INDEX.md`, `git submodule add <repo-url> tools/<repo-name>`, `./scripts/validate-reference-tool.sh references/<slug>.md`), exact file templates, and a literal table row format. The gap keeping it from 5: `cp templates/REFERENCE-tool.md references/<slug>.md` references a non-existent path (the real template is `assets/templates/REFERENCE-tool.yaml`), and the workflow steps defer some specifics (e.g., running the validator after step 5) rather than stating them inline.

4 / 5

Workflow Clarity

Ten numbered steps in a coherent order with real checkpoints: step 2's duplicate check with "If already present, report it and stop", explicit user-confirmation gates before vendoring (step 6) and promotion (steps 9-10), and schema validators for outputs. A 5 would embed the validation scripts directly into the workflow steps (e.g., "run validate-reference-tool.sh after step 5") with an explicit fix-and-retry loop rather than leaving them in Quick Commands.

4 / 5

Progressive Disclosure

Clear overview with well-signaled, one-level-deep references that all exist on disk: [classification guide](references/classification-guide.md) for taxonomy, `assets/templates/*.yaml` for field structures, `assets/schemas/*.schema.json`, and the two validator scripts — each deferred detail lives in exactly one bundle file and is linked with its purpose. The body holds only workflow-level guidance, matching the 5 anchor's structure.

5 / 5

Total

17

/

20

Passed

Description

91%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 that clearly states concrete deliverables and provides an unusually thorough explicit trigger list covering input forms (GitHub URL, npm, PyPI, CLI name) and synonyms. Third-person voice is used throughout, and it cleanly separates the 'what' from the 'when'. The only weaknesses are broad late-listed triggers (library, framework, open source project) that slightly raise conflict risk with other research/evaluation skills.

DimensionReasoningScore

Specificity

"Creates references/{slug}.md with architecture overview and scope assessment; adds REVIEWED.md entry and REFERENCE_INDEX.md row" lists several concrete, verifiable actions with named deliverables. Not a 5 because the action list covers only the core triage outputs — promotion to ANALYSIS-*.md and vendoring steps from the body are absent, a minor coverage gap.

4 / 5

Completeness

It explicitly answers both questions: what ("Triage a tool or library into a structured reference summary... Creates references/{slug}.md... adds REVIEWED.md entry") and when ("Use when given a GitHub URL, npm package, PyPI package, or CLI tool name" plus an explicit Triggers list with concrete phrases). This matches the 5-anchor example structure of a what-clause followed by an explicit when-clause with trigger phrases.

5 / 5

Trigger Term Quality

"Triggers: triage tool, add tool, analyse tool, GitHub project, npm package, PyPI package, library, framework, CLI tool, MCP server, open source project" plus "Use when given a GitHub URL, npm package, PyPI package, or CLI tool name" gives comprehensive natural-term coverage including synonyms (tool/library/framework/project) and artifact types. A 4 would require noticeably missing common terms, and the only marginal omission ('analyze' vs 'analyse' spelling) does not rise to that.

5 / 5

Distinctiveness Conflict Risk

"Triage a tool... into a structured reference summary for the research repo" carves a clear niche with distinct action verbs (triage/add to repo). Broad trigger terms like "library, framework, open source project, MCP server" create minor overlap risk with general research or evaluation skills, keeping it below the minimal-conflict 5 anchor.

4 / 5

Total

18

/

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.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

relative_links

Relative link issues: 6 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 3 missing, 9 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository
pantheon-org/tekhne
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.