pythonic-code

Write, refactor, and review Python for clarity, explicit behavior, local reasoning, strong types, constructive domain modeling, and minimal abstraction. Use when creating or changing nontrivial Python, simplifying object-heavy, helper-heavy, or overly procedural code, evaluating whether code is Pythonic, or reviewing Python maintainability in Basic Memory repositories.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

78%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 body is a concise, well-structured instruction skill with strong directive guidance and clear sequenced workflows including verification. Its main weakness is progressive disclosure: it is monolithic and does not link to the provided bundle script.

Suggestions

Add a short pointer to the bundled scripts/run_evals.py (e.g., in the Verify section) so Claude can discover and use the existing evaluation harness rather than improvising verification.

Consider moving the detailed per-topic guidance (e.g., 'Model The Positive Space', 'Prefer Functions Before Hierarchies') into a reference file and keeping SKILL.md as a concise overview with one-level-deep links.

Add an explicit validate-fix-retry feedback loop in the Verify The Result section (e.g., 'if the type checker or tests fail, fix and re-run before widening') to push workflow_clarity to 5.

Dimension	Reasoning	Score
Conciseness	Lean and efficient with no padding; it never explains concepts Claude already knows (what Python is, how libraries work) and every line carries directive guidance.	5 / 5
Actionability	Highly concrete directive guidance naming specific APIs (Pydantic, functools.singledispatch, typing.assert_never, match cases), but as an instruction-only style skill it lacks executable copy-paste examples despite referencing concrete idioms.	4 / 5
Workflow Clarity	Clear numbered sequences for Orient, Make Decisions, Write/Refactor/Review, and Verify, with an explicit verification section that widens by risk; only minor validation gaps as there is no explicit fix-and-retry feedback loop.	4 / 5
Progressive Disclosure	Sections are well-organized with clear headers, but all guidance is inlined in a single ~140-line file and the bundled scripts/run_evals.py is never referenced, so navigation to the bundle is missing.	3 / 5
	Total	16 / 20 Passed

Description

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

The description is specific, comprehensive, and clearly distinguishes the skill via concrete write/refactor/review actions and an explicit 'Use when' trigger clause. Third-person voice is used correctly throughout.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Write, refactor, and review Python') plus six named qualities (clarity, explicit behavior, local reasoning, strong types, constructive domain modeling, minimal abstraction), giving comprehensive coverage.	5 / 5
Completeness	Explicitly answers both what (write/refactor/review Python for named qualities) and when (a clear 'Use when...' clause with concrete triggers).	5 / 5
Trigger Term Quality	Includes natural user phrases like 'creating or changing nontrivial Python', 'simplifying object-heavy, helper-heavy, or overly procedural code', and 'evaluating whether code is Pythonic', but a few common synonyms (e.g., 'clean up', 'lint') are absent.	4 / 5
Distinctiveness Conflict Risk	Scoped specifically to Python and 'Basic Memory repositories', giving a clear niche with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: basicmachines-co/basic-memory
Path: .agents/skills/pythonic-code/SKILL.md
Commit: 3bf2d52

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.