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. 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 biological 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.
This skill is comprehensive and highly actionable with excellent executable code examples, but it severely suffers from verbosity and redundancy. Content is repeated across sections (e.g., shortest_path, centrality, I/O operations appear multiple times), and the skill explains concepts Claude already knows. The reference file structure is good but undermined by duplicating much of that content inline in the main file.
Suggestions
Cut the file by ~60%: remove the Quick Reference section (it duplicates earlier content), collapse the 'When to Use This Skill' into the Overview, and trim code examples to one per capability with references for more.
Remove explanations of concepts Claude already knows: graph type definitions, what hashable means, what floating point precision is, and what centrality measures conceptually represent.
Move detailed code examples for each capability (algorithms, generators, I/O, visualization) entirely into the reference files, keeping only one minimal example per section in the main skill.
Add validation/error handling guidance to the workflow: checking if a loaded graph is empty, verifying connectivity before running path algorithms, and handling missing attributes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose for a skill targeting Claude. Explains basic concepts Claude already knows (what graph types are, what centrality means), repeats code patterns across sections (e.g., shortest_path appears 3 times), includes a 'When to Use This Skill' section that restates the overview, and has a Quick Reference section that largely duplicates earlier content. The 'Important Considerations' section explains basic Python concepts like hashable types and floating point precision. | 1 / 3 |
Actionability | All code examples are fully executable, copy-paste ready Python with proper imports. Covers creation, analysis, I/O, and visualization with concrete, working code snippets. The Pandas integration and matrix format examples are particularly practical. | 3 / 3 |
Workflow Clarity | The 'Common Workflow Pattern' section provides a clear 5-step sequence (Create → Examine → Analyze → Visualize → Export), but lacks validation checkpoints. There's no error handling guidance, no verification steps after loading graphs or running algorithms, and no feedback loops for common failure modes like malformed input files or disconnected graphs affecting algorithm results. | 2 / 3 |
Progressive Disclosure | References to detailed files (references/graph-basics.md, references/algorithms.md, etc.) are well-signaled and one level deep, which is good. However, the main SKILL.md contains far too much inline content that duplicates what should be in those reference files—the Quick Reference section, the detailed code examples in each capability section, and the Resources section at the end all bloat the overview rather than deferring to the references. | 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 | |
25e1c0f
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.