Agent skill

Dignified Python Standards

by docling-project in docling-project/docling

Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.

Apache-2.0Auto-check passedDevelopment

Install Dignified Python Standards

skills CLI
$ npx skills add docling-project/docling --skill dignified-python -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install docling-project/docling dignified-python --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/docling-project/docling.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/dignified-python .claude/skills/dignified-python && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dignified-python
GitHub stars
69k
Token cost
~1.5k tokens
SKILL.md length
545 words
Files
16 (incl. references)
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.

  • Works in 4 steps: pyproject.toml - Look for… → setup.py or setup.cfg - Look for… → .python-version file - Contains version… → …
  • Writing new Python code to modern, production-style conventions
  • SKILL.md covers When to Use This Skill, When to Use This Skill vs.…, Core Knowledge (ALWAYS Loaded) and Version Detection, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill is general-purpose Python style guidance, not tied to any framework, and a project's own conventions can override it. It always loads a core guidance file, then detects the minimum Python version by checking requires-python in pyproject.toml, python_requires in setup.py or setup.cfg and a .python-version file, defaults to Python 3.12 if none is found, and loads the matching version file for 3.10, 3.11, 3.12 or 3.13.

It is invoked for requests to make code more Pythonic and for questions about type hints, LBYL versus EAFP exception handling, pathlib versus os.path, CLI patterns with click, and general code review or quality. Its leaning is toward looking before you leap, with explicit condition checks. Reference files cover module design, checklists, API design, exception handling, interfaces and advanced typing, with further notes on CLI patterns and subprocess use. Dagster-specific questions are routed to other skills.

When your agent uses it

  • Writing new Python code to modern, production-style conventions
  • Reviewing or refactoring Python for type hints, pathlib and exception handling
  • Deciding between LBYL and EAFP in a piece of code
  • Structuring a Python command-line tool

Example prompts

  • “Make this module more Pythonic and add modern type hints.”
  • “Replace the os.path calls in this script with pathlib.”
  • “Review this function: should it check conditions first or catch exceptions?”
  • “Refactor this click command so the logic is easy to test.”

Requirements

  • A Python project, version 3.10 to 3.13

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. pyproject.toml - Look for requires-python field (e.g., requires-python = ">=3.12")
  2. setup.py or setup.cfg - Look for python_requires
  3. .python-version file - Contains version like 3.12 or 3.12.0
  4. Default to Python 3.12 if no version specifier found

What it can do on your machine

Read from SKILL.md and the folder at commit 638c43a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dignified Python Standards loads about 1.5k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 78 tokens; SKILL.md has 545 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from docling-project/docling at commit 638c43a, republished under its Apache-2.0 licence (© docling-project). 545 words, ~1,479 tokens.

Download SKILL.mdSave it as .claude/skills/dignified-python/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
dignified-python
description
Opinionated production Python standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python in repos that want modern type syntax, explicit condition checks where practical, pathlib operations, interface guidance, and pragmatic production patterns.
references
dignified-python-core, cli-patterns, versions/python-3.10, versions/python-3.11, versions/python-3.12, versions/python-3.13, references/advanced/api-design…

Dignified Python

Opinionated Python guidance for writing clean, maintainable, modern Python code (versions 3.10-3.13).

When to Use This Skill

Auto-invoke when users ask about:

  • "make this pythonic" / "is this good python"
  • "type hints" / "type annotations" / "typing"
  • "LBYL vs EAFP" / "exception handling"
  • "pathlib vs os.path" / "path operations"
  • "CLI patterns" / "click usage"
  • "code review" / "improve this code"
  • Any Python code quality or standards question

Note: This skill is general-purpose Python style guidance, not Dagster-specific. It captures one explicit, LBYL-leaning set of conventions; project conventions can override it when needed.

When to Use This Skill vs. Others

User NeedUse This SkillAlternative Skill
"make this pythonic"✅ Yes - Python standards
"is this good python"✅ Yes - code quality
"type hints"✅ Yes - typing guidance
"LBYL vs EAFP"✅ Yes - exception patterns
"pathlib vs os.path"✅ Yes - path handling
"best practices for dagster"❌ No/dagster-best-practices
"implement X pipeline"❌ No/dg for implementation
"which integration to use"❌ No/dagster-expert
"CLI argument parsing"✅ Yes - CLI patterns

Core Knowledge (ALWAYS Loaded)

@dignified-python-core.md

Version Detection

Identify the project's minimum Python version by checking (in order):

  1. pyproject.toml - Look for requires-python field (e.g., requires-python = ">=3.12")
  2. setup.py or setup.cfg - Look for python_requires
  3. .python-version file - Contains version like 3.12 or 3.12.0
  4. Default to Python 3.12 if no version specifier found

Once identified, load the appropriate version-specific file:

  • Python 3.10: Load versions/python-3.10.md
  • Python 3.11: Load versions/python-3.11.md
  • Python 3.12: Load versions/python-3.12.md
  • Python 3.13: Load versions/python-3.13.md

Conditional Loading (Load Based on Task Patterns)

Core files above cover 80%+ of Python code patterns. Only load these additional files when you detect specific patterns:

Pattern detection examples:

  • If task mentions "click" or "CLI" -> Load cli-patterns.md
  • If task mentions "subprocess" -> Load subprocess.md

Reference Documentation Structure

This skill's reference material is organized by topic:

Core References
  • dignified-python-core.md - Essential standards (always loaded)
  • cli-patterns.md - Command-line interface patterns (click, argparse)
Version-Specific References (versions/)
  • python-3.10.md - Features available in Python 3.10+
  • python-3.11.md - Features available in Python 3.11+
  • python-3.12.md - Features available in Python 3.12+
  • python-3.13.md - Features available in Python 3.13+
Show full SKILL.md (220 more words)Show less
Advanced Topics (references/advanced/)
  • exception-handling.md - LBYL patterns, error boundaries
  • interfaces.md - ABC and Protocol patterns
  • typing-advanced.md - Advanced typing patterns
  • api-design.md - API design principles

When to Read Each Reference Document

references/advanced/exception-handling.md

Read when:

  • Writing try/except blocks
  • Wrapping third-party APIs that may raise
  • Seeing or writing from e or from None
  • Unsure if LBYL alternative exists
references/advanced/interfaces.md

Read when:

  • Creating ABC or Protocol classes
  • Writing @abstractmethod decorators
  • Designing gateway layer interfaces
  • Choosing between ABC and Protocol
references/advanced/typing-advanced.md

Read when:

  • Using typing.cast()
  • Creating Literal type aliases
  • Narrowing types in conditional blocks
references/module-design.md

Read when:

  • Creating new Python modules
  • Adding module-level code (beyond simple constants)
  • Using @cache decorator at module level
  • Seeing Path() or computation at module level
  • Considering inline imports
references/advanced/api-design.md

Read when:

  • Adding default parameter values to functions
  • Defining functions with 5 or more parameters
  • Using ThreadPoolExecutor.submit()
  • Reviewing function signatures
references/checklists.md

Read when:

  • Final review before committing Python code
  • Unsure if you've followed all rules
  • Need a quick lookup of requirements

How to Use This Skill

  1. Core knowledge is loaded automatically (defaults, pathlib, imports, anti-patterns)
  2. Version detection happens once - identify the minimum Python version and load the appropriate version file
  3. Reference documents are loaded on-demand based on the triggers above
  4. Additional patterns may require extra loading (CLI patterns, subprocess)
  5. Each file is self-contained with complete guidance for its domain

© docling-project, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (references) in .agents/skills/dignified-python of docling-project/docling.

  • SKILL.md
  • LICENSE
  • cli-patterns.md
  • dignified-python-core.md
  • references/README.md
  • references/advanced/api-design.md
  • references/advanced/exception-handling.md
  • references/advanced/interfaces.md
  • references/advanced/typing-advanced.md
  • references/checklists.md
  • references/module-design.md
  • subprocess.md
  • versions/python-3.10.md
  • versions/python-3.11.md
  • versions/python-3.12.md
  • versions/python-3.13.md

Open the folder on GitHubat commit 638c43a

Compare with similar skills

Dignified Python Standards next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dignified Python Standards compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dignified Python Standards this skilldocling-project/docling69k—~1.5kAutomated safety check: PassApache-2.0
Code Revieweralirezarezvani/claude-skills28k1 repos~1.6kAutomated safety check: PassMIT
Code ReviewerLeoYeAI/openclaw-master-skills2.2k1 repos~1.2kAutomated safety check: PassMIT
Code Reviewerborghei/Claude-Skills881—~1.7kAutomated safety check: PassMIT
Framer SDK Patternsjeremylongshore/tons-of-skills-marketplace2.8k—~1.6kAutomated safety check: PassMIT
Clean Code GuardamElnagdy/guard-skills1.3k2 repos~4.3kAutomated safety check: PassMIT

Similar skills

  • Code Reviewer

    alirezarezvani/claude-skills

    Code review automation for TypeScript, JavaScript, Python, Go, Swift, Kotlin, C, .NET, Java, C, C++, Rust, Ruby, PHP, and Dart/Flutter.

    28k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Code Reviewer

    LeoYeAI/openclaw-master-skills

    Code review automation for TypeScript, JavaScript, Python, Go, Swift, Kotlin.

    2.2k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • Code Reviewer

    borghei/Claude-Skills

    Code review automation for TypeScript, JavaScript, Python, Go, Swift, and Kotlin.

    881 GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Framer SDK Patterns

    jeremylongshore/tons-of-skills-marketplace

    Apply production-ready Framer SDK patterns for TypeScript and Python.

    2.8k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Clean Code Guard

    amElnagdy/guard-skills

    Reviews generated or changed production code against Clean Code, SOLID, DRY, KISS, YAGNI and LLM-specific failure modes before it ships, in any language.

    1.3k GitHub starsUsed in 2 repos~4.3k tokens
    DevelopmentAuto-check passed
  • Code Review Skill

    awesome-skills/code-review-skill

    Provides comprehensive code review guidance for React 19, Vue 3, Angular 17+, Svelte 5, Rust, TypeScript, Java, Java 8, PHP, Ruby, Rails, Python, Django, FastAPI, Go, C/.NET, Kotlin, Swift, Dart…

    2.1k GitHub stars~2.8k tokensUpdated 29 days ago
    DevelopmentAuto-check: notes

More from docling-project/docling

  • Building Pydantic AI Agents

    docling-project/docling

    Patterns and tested examples for building agents with Pydantic AI: tools, capabilities, structured output, dependency injection, hooks, YAML specs, streaming and testing.

    69k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Docling Document Conversion

    docling-project/docling

    Converts PDFs, Office files, HTML, images and other documents into a unified DoclingDocument with Markdown or JSON output, through the docling CLI, Python SDK or a remote service.

    69k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Docling Pull Request Review

    docling-project/docling

    Reviews or re-reviews a Docling pull request in fixed stages, with findings that can be reproduced and an explicit record of every check that was run.

    69k GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Dignified Python Standards

What does Dignified Python Standards do?

Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance. The skill is general-purpose Python style guidance, not tied to any framework, and a project's own conventions can override it.13.

When should I use Dignified Python Standards?

Dignified Python Standards fits situations like: writing new Python code to modern, production-style conventions; reviewing or refactoring Python for type hints, pathlib and exception handling; deciding between LBYL and EAFP in a piece of code; structuring a Python command-line tool.

How do I install Dignified Python Standards in Claude Code?

Run `npx skills add docling-project/docling --skill dignified-python -a claude-code`. Or copy the skill folder (.agents/skills/dignified-python in docling-project/docling) into .claude/skills/dignified-python in your project. Claude Code loads it when a task matches its description.

How do I install Dignified Python Standards in Codex?

Run `npx skills add docling-project/docling --skill dignified-python -a codex`. Or copy the skill folder (.agents/skills/dignified-python in docling-project/docling) into .agents/skills/dignified-python in your project. Codex loads it when a task matches its description.

Can I use Dignified Python Standards in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add docling-project/docling --skill dignified-python -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dignified-python, .gemini/skills/dignified-python, .github/skills/dignified-python and .opencode/skills/dignified-python in your project.

What does Dignified Python Standards need to run?

SKILL.md names no scripts, command-line tools or credentials: Dignified Python Standards is instructions for the agent only. Our summary lists: A Python project, version 3.10 to 3.13.

Does Dignified Python Standards access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dignified Python Standards safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dignified Python Standards use?

Dignified Python Standards is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dignified Python Standards use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 10k tokens, read only when the agent opens those files.

What are the alternatives to Dignified Python Standards?

Skills that share tags, products or a category with Dignified Python Standards: Code Reviewer (alirezarezvani/claude-skills, 28k stars), Code Reviewer (LeoYeAI/openclaw-master-skills, 2.2k stars), Code Reviewer (borghei/Claude-Skills, 881 stars) and Framer SDK Patterns (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dignified Python Standards?

docling-project (a GitHub organization) maintains it in docling-project/docling, which has 68,515 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 8, 2026.

Source: docling-project/docling on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.