python-typing-patterns
Python type hints and type safety patterns. Triggers on: type hints, typing, TypeVar, Generic, Protocol, mypy, pyright, type annotation, overload, TypedDict.
Install with Tessl CLI
npx tessl i github:NeverSight/skills_feed --skill python-typing-patterns88
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
72%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 excels at trigger term coverage with comprehensive Python typing keywords that users would naturally use. However, it lacks specificity about what actions the skill performs - it tells Claude when to use it but not what it will do. The description would benefit from concrete capability statements.
Suggestions
Add specific actions the skill performs, e.g., 'Adds type annotations to functions, fixes mypy/pyright errors, converts untyped code to typed code, implements Generic classes and Protocols.'
Restructure to lead with capabilities before triggers, e.g., 'Adds and fixes Python type annotations, implements generic types and protocols, resolves type checker errors. Triggers on: ...'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Python type hints) and mentions 'type safety patterns' but doesn't list concrete actions like 'add type annotations', 'fix type errors', or 'convert untyped code'. The description focuses on trigger terms rather than capabilities. | 2 / 3 |
Completeness | Has a 'Triggers on:' clause which serves as explicit trigger guidance, but the 'what does this do' portion is weak - 'type hints and type safety patterns' doesn't explain what actions Claude will perform with this skill. | 2 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'type hints', 'typing', 'TypeVar', 'Generic', 'Protocol', 'mypy', 'pyright', 'type annotation', 'overload', 'TypedDict'. These are exactly what developers would mention when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche with highly specific Python typing terminology. The trigger terms like 'mypy', 'pyright', 'TypeVar', 'Protocol' are distinctive and unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill file that demonstrates excellent token efficiency while providing comprehensive, actionable guidance on Python typing patterns. The content is well-organized with a logical progression from basic to advanced concepts, includes a helpful quick reference table, and appropriately delegates advanced topics to referenced files. The code examples are all executable and practical.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient - every section provides concrete code examples without explaining what type hints are or why they matter. Assumes Claude's competence with Python and jumps straight to patterns. | 3 / 3 |
Actionability | All code examples are fully executable and copy-paste ready. Covers practical patterns from basic annotations through advanced Protocol and TypeGuard usage with real, working code. | 3 / 3 |
Workflow Clarity | For a reference skill about type patterns, the organization is clear and logical. Includes concrete type checker commands and configuration. No multi-step destructive operations requiring validation checkpoints. | 3 / 3 |
Progressive Disclosure | Excellent structure with quick reference table, clear sections for increasing complexity, and well-signaled one-level-deep references to advanced topics (generics-advanced.md, protocols-patterns.md, etc.). | 3 / 3 |
Total | 12 / 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 |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- 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.