CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

citation-network

Build and visualize a citation network from a source/target CSV to identify key papers, communities, and emerging hotspots; use when you have citation pairs and need fast literature review or trend analysis.

Quality

81%

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

73%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.

The core workflow is excellent: a clear, validated, copy-paste-ready five-step procedure with real bundle scripts and concrete failure-mode recovery. Quality is dragged down by generic template boilerplate in the second half, a conceptual section re-teaching known network-analysis concepts, and a dangling references/README.md link.

Suggestions

Trim the generic boilerplate sections (Required Inputs, Output Contract, User Checkpoints, Input Validation, Quick Validation) or replace them with skill-specific content, e.g., a concrete example of what a valid citations.csv and resulting network_metrics.json look like for this skill.

Remove or rewrite "Metrics and Analysis (Conceptual)": Claude already knows degree/betweenness/Louvain; instead state only what network_metrics.json actually contains and how community detection is (or is not) invoked by the build script.

Fix the dangling reference: either create references/README.md or remove the "Additional documentation: `references/README.md`" line so every referenced path resolves to a real bundle file.

DimensionReasoningScore

Conciseness

The workflow half (When to Use through Example Usage) is efficient, but roughly a third of the body is generic boilerplate (Required Inputs table, Output Contract, User Checkpoints, Input Validation, Quick Validation) that adds no skill-specific value, and "Metrics and Analysis (Conceptual)" re-explains degree/betweenness/Louvain, which Claude already knows. Mostly efficient overall, so anchor 3 fits better than the noticeably-verbose anchor 2.

3 / 5

Actionability

Steps give copy-paste commands ("python scripts/init_run.py", "python scripts/build_citation_network.py"), exact CSV formats, and exact output paths, all matching real bundle scripts. Minor gaps — hedged guidance like "via an `input_encoding` field if supported by the config" and "community detection... if enabled/implemented" — keep it below the fully-executable anchor 5.

4 / 5

Workflow Clarity

A clear five-step sequence (init run → prepare CSV → confirm config → build → inspect outputs) with an explicit config-confirmation checkpoint, expected-output verification, feedback loops in Common Failure Modes (garbled characters → set encoding; empty output → check headers), and a validation checklist in Quick Validation. This matches the anchor-5 pattern of explicit validation plus error-recovery loops rather than the minor-gaps anchor 4.

5 / 5

Progressive Disclosure

The body is a well-organized overview with one-level-deep, clearly signaled references (data-cleaning-checklist.md and network-metrics-notes.md, both real bundle files). However, "Additional documentation: `references/README.md`" points to a file that does not exist in references/, a navigation defect that fits anchor 4's minor organization gaps rather than anchor 5's easy navigation.

4 / 5

Total

16

/

20

Passed

Description

83%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 and concisely states both capability and explicit trigger conditions with natural phrasing and third-person-style imperative voice. The only gaps are slightly incomplete action coverage and a few missing synonym trigger terms.

DimensionReasoningScore

Specificity

"Build and visualize a citation network from a source/target CSV to identify key papers, communities, and emerging hotspots" names several concrete actions (build, visualize, identify key papers/communities/hotspots) plus the input format. Not 5 because core capabilities like GEXF/HTML export and network metrics are not mentioned, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both: what ("Build and visualize a citation network from a source/target CSV to identify key papers, communities, and emerging hotspots") and when ("use when you have citation pairs and need fast literature review or trend analysis") with concrete trigger phrases, matching the anchor-5 pattern exactly.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "citation network", "citation pairs", "literature review", "trend analysis", "source/target CSV". A few common synonyms/extensions are missing (e.g., "citation analysis", "bibliometric", ".csv"), so it matches anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Citation pairs" and "source/target CSV" carve a clear niche distinct from generic data skills, but "literature review" and "trend analysis" could overlap with broader literature-review skills, fitting the mostly-distinct anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

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

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

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Evidence Insight/citation-network/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.