sniffable-python
Structure Python so LLMs can understand it in 50 lines.
npx skills add majiayu000/claude-skill-registry --skill sniffable-python-simhacker-moollm --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Sniffable Python > **"Structure code for the first 50 lines. That's all the LLM needs."** Don't invent new syntax — **structure existing syntax** for optimal LLM comprehension. *If your code smells good, the LLM can sniff it from the first whiff.* *Steve Jobs wanted pixels you could lick. We want code you can sniff.* --- ## The Problem LLMs can read Python. But: - Large files overwhelm context - Implementation details bury the API - Comments scattered or missing - No clear entry point for understanding **Solution:** Structure Python so the first ~50 lines contain everything needed to understand and use the tool. Make your code's bouquet apparent from the opening notes. --- ## The Pattern ### Canonical Structure ```python #!/usr/bin/env python3 """skill-name: Brief description of what the script does. This docstring becomes --help output AND is immediately visible to the LLM. It should contain: - Purpose (one sentence) - Usage examples - Key behaviors Usage: python script.py command [options] Examples: python script.py move north --quiet python script.py examine sword --verbose """ import argparse from pathlib import Path import yaml # Configuration DEFAULT_ROOM = "start" VALID_DI
- The Problem
- The Pattern
- Canonical Structure
- The Zones
- Why This Works
- Dual-Audience Design
- DRY Principle
- Why Syntax Compression Fails
- The Symbol Collision Problem
- Comprehension Fidelity > Token Count
- Comments as YAML Jazz
- Comments: Substance Over Decoration
- Argparse vs Click vs Typer
- The Argparse Advantage
What does the sniffable-python skill do?
Structure Python so LLMs can understand it in 50 lines.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill sniffable-python-simhacker-moollm --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.