Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python. Use when working with network/graph data structures, analyzing relationships between entities, computing graph algorithms (shortest paths, centrality, clustering), detecting communities, generating synthetic networks, or visualizing network topologies. Applicable to social networks, biological networks, transportation systems, citation networks, and any domain involving pairwise relationships.
79
75%
Does it follow best practices?
Impact
81%
1.26xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/networkx/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-crafted skill description that excels across all dimensions. It provides specific concrete actions, includes an explicit 'Use when...' clause with rich trigger terms, covers multiple application domains, and occupies a clearly distinct niche in network/graph analysis. The description uses proper third-person voice throughout and balances comprehensiveness with clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creating, analyzing, visualizing networks, computing graph algorithms (shortest paths, centrality, clustering), detecting communities, generating synthetic networks, and visualizing network topologies. | 3 / 3 |
Completeness | Clearly answers both 'what' (creating, analyzing, visualizing networks, computing graph algorithms, detecting communities, generating synthetic networks) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios and applicable domains. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'network', 'graph', 'shortest paths', 'centrality', 'clustering', 'communities', 'social networks', 'biological networks', 'transportation systems', 'citation networks', 'relationships', 'Python'. These are terms users would naturally use when requesting network analysis. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly occupies a distinct niche around network/graph analysis in Python. The specific mention of graph algorithms, community detection, network topologies, and domain examples like social networks and citation networks makes it highly distinguishable from general data analysis or visualization skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides excellent actionable code examples covering all major NetworkX capabilities, but suffers from significant verbosity and redundancy. Content that belongs in reference files is duplicated inline, the Quick Reference section repeats earlier examples, and the Resources section redundantly describes already-linked references. The workflow section is reasonable but lacks validation steps for error-prone operations like file I/O.
Suggestions
Reduce the main SKILL.md to a concise overview with 1-2 brief examples per capability, moving detailed code to the reference files where they belong — this could cut the file by 50%+.
Remove the 'Quick Reference' section entirely as it duplicates code already shown in the main sections, or make it the only code in the main file and move all detailed examples to references.
Eliminate the redundant 'Resources' section at the bottom that re-describes the same reference files already linked inline throughout the document.
Add validation guidance to the workflow pattern, such as checking if a file exists before reading, verifying graph connectivity before running algorithms that require it, and handling common exceptions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines, with significant redundancy. The 'Quick Reference' section largely duplicates code already shown in the main sections. The overview and 'When to Use This Skill' sections explain obvious concepts Claude already knows. The 'Important Considerations' section includes basic Python knowledge (hashable types, floating point precision). The Resources section at the end redundantly describes the same reference files already linked inline. | 1 / 3 |
Actionability | The skill provides fully executable, copy-paste ready Python code throughout. Every major capability area includes concrete, runnable examples with proper imports and realistic parameters. Code covers creation, analysis, I/O, and visualization with specific function calls and arguments. | 3 / 3 |
Workflow Clarity | The 'Common Workflow Pattern' section provides a clear 5-step sequence (create, examine, analyze, visualize, export) with code examples. However, there are no validation checkpoints or error recovery steps — no guidance on what to do if a graph fails to load, if algorithms raise exceptions on disconnected graphs, or if visualization fails. For a skill involving file I/O and data processing, some validation would be expected. | 2 / 3 |
Progressive Disclosure | The skill references five separate reference files (graph-basics.md, algorithms.md, generators.md, io.md, visualization.md) which is good structure. However, the main SKILL.md contains too much inline detail that should be in those reference files — the extensive code examples for each capability area make the main file bloated. The references are also listed twice (inline and in the Resources section), adding redundancy. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
cbcae7b
Table of Contents
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.