python-math
Small Python utilities for math and text files.
49
Quality
36%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./examples/skillrun/skills/python_math/SKILL.mdQuality
Discovery
0%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 description is critically underdeveloped across all dimensions. It provides no concrete actions, lacks natural trigger terms users would say, offers no guidance on when to use the skill, and is so generic it would conflict with many other skills. The description fails to help Claude distinguish this skill from others.
Suggestions
List specific concrete actions the skill performs (e.g., 'Calculate statistics, parse CSV files, count word frequencies, perform arithmetic operations').
Add a 'Use when...' clause with natural trigger terms (e.g., 'Use when the user asks to calculate numbers, read .txt files, process CSV data, or perform basic math operations').
Specify the types of files and operations more precisely to create a distinct niche (e.g., '.txt files, .csv files, numerical calculations, text parsing').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language ('utilities', 'math and text files') without listing any concrete actions. It doesn't specify what operations are performed on math or text files. | 1 / 3 |
Completeness | The description weakly addresses 'what' (utilities for math and text) but provides no 'when' guidance. There is no 'Use when...' clause or explicit trigger guidance. | 1 / 3 |
Trigger Term Quality | The terms 'math', 'text files', and 'Python utilities' are overly generic and don't reflect natural user language. Missing specific trigger terms like 'calculate', 'parse', 'read file', or file extensions. | 1 / 3 |
Distinctiveness Conflict Risk | Extremely generic - 'Python utilities', 'math', and 'text files' could overlap with countless other skills. No clear niche or distinguishing characteristics. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a concise, well-structured skill that efficiently communicates its purpose. However, it lacks completeness in actionability - the referenced fib.py script isn't provided, and there's no guidance on error handling or output validation. The examples would benefit from showing expected outputs.
Suggestions
Include the actual fib.py script content or indicate where it's located in the workspace
Add expected output examples (e.g., what fib.txt should contain for N=10)
Add a brief note on error handling or how to verify script execution succeeded
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Very lean content with no unnecessary explanation. Assumes Claude knows Python and shell basics. Every line serves a purpose. | 3 / 3 |
Actionability | Provides executable commands but the examples are incomplete - fib.py script isn't shown, and the sum example lacks input demonstration. The heredoc example is executable but context is missing. | 2 / 3 |
Workflow Clarity | For a simple skill, the steps are understandable but there's no validation or error handling guidance. No mention of what to do if scripts fail or how to verify output correctness. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single purpose, the structure is appropriate. Clear sections for overview, examples, and outputs. No need for external references given the scope. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- trpc-group/trpc-agent-go
- Commit
8763418
- 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.