python-specifications

A Python code-checking guide that uses type checkers and linters to inspect source files. Type checkers find mismatched values and incorrect function signatures; linters find common mistakes and unused code.

In plain words
What is it for?
Use it when planning, writing, or reviewing Python files and project configuration. It helps decide whether to run mypy or pyright for types, and ruff or flake8 for code issues.
Why use it?
It catches many errors before the program runs and gives a consistent minimum check for Python changes.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/danweinerdev/claude-sdd-planner/python-specifications
Any agent
npx skills add danweinerdev/claude-sdd-planner --skill python-specifications
Clone the repo
git clone --depth 1 https://github.com/danweinerdev/claude-sdd-planner

Made for: Claude Code, Codex.

Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 193 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00052 $0.00193
Opus 5 $0.00026 $0.00097
Sonnet 5 $0.00010 $0.00039
Haiku 4.5 $0.00005 $0.00019

Measured yesterday against content hash 6602126ca1ff, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

python-specifications scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/python-specifications/SKILL.md · 19 lines

What it actually says

Python — Structural Verification

Tools

Tool When What it catches
Type checker (mypy / pyright) Project uses type annotations Type mismatches, missing attributes, incorrect signatures
Linter (ruff / flake8) If configured in project Unused imports, undefined names, common bugs

Minimum Bar

Run the type checker if the project has type annotations or a py.typed marker. Run the linter if configured (check pyproject.toml, setup.cfg, ruff.toml).

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 19 lines · 52 tokens per session scan A 6602126ca1ff

Subscribe to this mod's changes

python-specifications is a skill published in the GitHub repository danweinerdev/claude-sdd-planner (2 stars, last pushed 3d ago), licensed MIT. It adds 52 tokens to every session and 193 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

moai-kanban-foreman

One unattended kanban foreman iteration: watch the backlog queue, dispatch the next operator-picked card to an isolated worker, collect completion evidence on read (not on claims), and report. This is the body the project's loop.md driver invokes each iteration of a bare /loop; it can also be invoked directly to test…

modu-ai/moai-adk · 76 tokens

moai-workflow-project

Integrated project management system covering documentation, language initialization, template optimization, docs generation, and JIT document loading. Absorbed from moai-workflow-templates, moai-docs-generation, and moai-workflow-jit-docs.

modu-ai/moai-adk · 55 tokens

stale-ticket-triage

Replace the weekly "look at every ticket older than X days" meeting with a scheduled AI scan that picks close / snooze / keep per ticket plus a one-sentence reason, so a PM can bulk-approve in 90 seconds Monday morning.

aozyildirim/Agena · 57 tokens

weather-fetcher

Instructions for fetching current weather temperature data for Dubai, UAE from Open-Meteo API.

shanraisshan/claude-code-best-practice · 21 tokens

time-skill

Display the current time in Pakistan Standard Time (PKT, UTC+5). Use when the user asks for the current time, Pakistan time, or PKT.

shanraisshan/claude-code-best-practice · 37 tokens

hns-workflow-ci-loop

Unified CI watch + auto-fix loop skill. Polls gh pr checks after /moai sync PR creation, classifies required vs auxiliary failures, attempts safe automated patches (max 3 iterations), and escalates semantic failures to the user. Use for CI loop workflow — NOT for general loop iteration patterns (see…

modu-ai/moai-adk · 76 tokens