hatchling
Hatchling
Overview
Hatchling is a modern, standards-compliant Python build backend that replaces legacy setuptools for package building. It provides clear configuration through pyproject.toml, intelligent defaults, and extensibility through hooks and plugins. This skill enables understanding Hatchling's architecture, configuration options, and build customization capabilities.
Key Capabilities
Consult ../python3-development/references/python3-standards.md when applying shared architecture, typing, testing, or CLI rules; full standards, graphs, and amendment process are documented there.
- Configuration via pyproject.toml: Standards-compliant PEP 621 metadata with sensible defaults
- Build Targets: Wheel and source distribution builds with extensive customization
- Build Hooks: Dynamic code execution during build for artifacts, version management, and compilation
- Version Management: Multiple version sources with automatic version injection
- File Selection: Git-aware VCS integration with glob pattern matching
- Plugins: Extensible architecture for custom builders, hooks, and metadata hooks
Reference Documentation
This skill provides comprehensive reference documentation organized by topic. Each section links to detailed guides covering configuration, usage patterns, and examples.
Project Configuration
references/project-metadata/index.md- Package metadata, dependencies, entry points, dynamic fieldsreferences/build-system/index.md- Build backend setup, PEP 517/518, reproducible builds, environment variables
Build Targets
references/wheel-target/index.md- Wheel configuration, package discovery, file selection, editable installsreferences/sdist-target/index.md- Sdist configuration, VCS integration, legacy setup.py supportreferences/build-targets/index.md- Wheel, sdist, binary, custom builders, multi-version buildsreferences/target-config/index.md- Target-specific hooks, dependencies, versions, precedence
File Selection & Build Customization
references/file-selection/index.md- Git-style globs, include/exclude patterns, VCS integration, force-includereferences/build-hooks/index.md- Hook interface, execution order, custom hooks, version hooks, build data passingreferences/advanced-features/index.md- Dynamic dependencies, force-include, path rewriting, editable installs, build context
Version & Metadata Management
references/version-management/index.md- Version sources (code, regex, env), schemes, validation, build hooksreferences/metadata-hooks/index.md- Metadata hook interface, custom hooks, dynamic metadata generationreferences/context-formatting/index.md- Context variables, environment-based config, interpolation
Plugin System
references/plugins/index.md- Builder, hook, metadata, version plugins, hatch-vcs, plugin development
Build Environment & Integration
references/build-environment/index.md- Environment config, dependencies, UV vs pip, Cython integration, isolationreferences/integration/index.md- PEP standards compliance, setup.py migration, setuptools compatibility, CMake/extensionsreferences/special-config/index.md- PEP 561 type hints, SPDX licenses, namespace packages, src-layout, extensions
Core Concepts & Standards
references/core-concepts/index.md- PEP 517 backend, minimal philosophy, VCS file selection, reproducible buildsreferences/standards/index.md- Python packaging overview, PEP references, metadata specs, distribution formats
Operational Guides
references/cli-building/index.md- hatch build commands, python -m build, pip install, output customizationreferences/error-handling/index.md- Path validation, file selection errors, version/license validation, heuristic failuresreferences/release-notes/index.md- Hatchling version history, feature additions, PEP 639 support, performance improvements
More from jamie-bitflight/claude_skills
perl-lint
This skill should be used when the user asks to lint Perl code, run perlcritic, check Perl style, format Perl code, run perltidy, or mentions Perl Critic policies, code formatting, or style checking.
24brainstorming-skill
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using 30+ research-validated prompt patterns.
11design-anti-patterns
Enforce anti-AI UI design rules based on the Uncodixfy methodology. Use when generating HTML, CSS, React, Vue, Svelte, or any frontend UI code. Prevents "Codex UI" — the generic AI aesthetic of soft gradients, floating panels, oversized rounded corners, glassmorphism, hero sections in dashboards, and decorative copy. Applies constraints from Linear/Raycast/Stripe/GitHub design philosophy: functional, honest, human-designed interfaces. Triggers on: UI generation, dashboard building, frontend component creation, CSS styling, landing page design, or any task producing visual interface code.
7python3-review
Comprehensive Python code review checking patterns, types, security, and performance. Use when reviewing Python code for quality issues, when auditing code before merge, or when assessing technical debt in a Python codebase.
7hooks-guide
Cross-platform hooks reference for AI coding assistants — Claude Code, GitHub Copilot, Cursor, Windsurf, Amp. Covers hook authoring in Node.js CJS and Python, per-platform event schemas, inline-agent hooks and MCP in agent frontmatter, common JSON I/O, exit codes, best practices, and a fetch script to refresh docs from official sources. Use when writing, reviewing, or debugging hooks for any AI assistant.
7agent-creator
Create high-quality Claude Code agents from scratch or by adapting existing agents as templates. Use when the user wants to create a new agent, modify agent configurations, build specialized subagents, or design agent architectures. Guides through requirements gathering, template selection, and agent file generation following Anthropic best practices (v2.1.63+).
6