Skip to content
cccskills
FreePublished on GitHub

hatchling

Provides Hatchling build backend guidance for Python packaging — use when configuring pyproject.toml metadata, build targets (wheel, sdist, binary), file selection with git-style globs, build hooks, metadata hooks, version management (code/regex/env sources), editable installs, the hatch-vcs plugin, plugin development, build environment setup (UV/pip/Cython), setuptools migration, or troubleshooting Hatchling errors. Covers PEP 517/518/621/660 standards and context variable interpolation.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills
See how to install

Files included (182)

  • SKILL.md4.4 KB
  • hatchling.TODO.md8.5 KB
  • references/advanced-features/artifact-directories.md8.1 KB
  • references/advanced-features/build-context.md8.3 KB
  • references/advanced-features/build-data-passing.md6.5 KB
  • references/advanced-features/case-insensitive-filesystems.md8.5 KB
  • references/advanced-features/distributed-artifacts.md8.0 KB
  • references/advanced-features/dynamic-dependencies.md3.4 KB
  • references/advanced-features/editable-installs.md6.4 KB
  • references/advanced-features/force-include.md5.1 KB
  • references/advanced-features/index.md1.6 KB
  • references/advanced-features/path-rewriting.md6.1 KB
  • references/build-environment/build-dependencies-management.md9.1 KB
  • references/build-environment/build-environment-configuration.md6.1 KB
  • references/build-environment/cython-build-tools.md12.3 KB
  • references/build-environment/environment-isolation.md10.2 KB
  • references/build-environment/environment-variables.md9.8 KB
  • references/build-environment/index.md2.6 KB
  • references/build-environment/uv-vs-pip-installer.md10.2 KB
  • references/build-hooks/build-data.md11.0 KB
  • references/build-hooks/buildhook-interface.md10.9 KB
  • references/build-hooks/conditional-execution.md7.4 KB
  • references/build-hooks/configuration.md5.0 KB
  • references/build-hooks/custom-build-hooks.md12.2 KB
  • references/build-hooks/environment-variables.md9.9 KB
  • references/build-hooks/execution-order.md6.0 KB
  • references/build-hooks/hook-data-passing.md12.5 KB
  • references/build-hooks/hook-dependencies.md11.3 KB
  • references/build-hooks/index.md5.4 KB
  • references/build-hooks/version-build-hook.md9.7 KB
  • references/build-system/build-options.md6.6 KB
  • references/build-system/build-system-declaration.md5.4 KB
  • references/build-system/dev-mode.md7.4 KB
  • references/build-system/environment-variables.md7.5 KB
  • references/build-system/index.md3.2 KB
  • references/build-system/output-directory.md6.4 KB
  • references/build-system/pep-standards.md6.4 KB
  • references/build-system/reproducible-builds.md7.3 KB
  • references/build-system/vcs-integration.md6.8 KB
  • references/build-targets/binary-builder.md9.3 KB
  • references/build-targets/custom-builder.md11.5 KB
  • references/build-targets/index.md3.7 KB
  • references/build-targets/multi-version-builds.md13.9 KB
  • references/build-targets/sdist-builder.md7.7 KB
  • references/build-targets/target-dependencies.md14.3 KB
  • references/build-targets/third-party-builders.md12.0 KB
  • references/build-targets/wheel-builder.md6.8 KB
  • references/cli-building/building-all-targets.md6.9 KB
  • references/cli-building/building-sdist.md5.8 KB
  • references/cli-building/building-wheels.md5.0 KB
  • references/cli-building/index.md4.2 KB
  • references/cli-building/local-install.md7.6 KB
  • references/cli-building/output-customization.md8.8 KB
  • references/cli-building/overview.md1.8 KB
  • references/cli-building/python-build-tool.md7.4 KB
  • references/context-formatting/configuration-interpolation.md10.4 KB
  • references/context-formatting/dynamic-configuration.md11.9 KB
  • references/context-formatting/environment-fields.md8.2 KB
  • references/context-formatting/global-fields.md8.6 KB
  • references/context-formatting/index.md13.0 KB
  • references/context-formatting/optional-dependencies.md8.9 KB
  • references/context-formatting/RESEARCH-SUMMARY.md10.2 KB
  • references/core-concepts/build-hooks.md11.7 KB
  • references/core-concepts/development-vs-distribution.md10.9 KB
  • references/core-concepts/index.md9.1 KB
  • references/core-concepts/minimal-philosophy.md7.9 KB
  • references/core-concepts/pep-517-backend.md6.1 KB
  • references/core-concepts/reproducible-builds.md10.7 KB
  • references/core-concepts/vcs-file-selection.md9.6 KB
  • references/core-concepts/version-management.md11.1 KB
  • references/core-concepts/wheel-vs-sdist.md11.7 KB
  • references/error-handling/build-validation.md12.9 KB
  • references/error-handling/heuristic-failures.md9.8 KB
  • references/error-handling/index.md8.0 KB
  • references/error-handling/metadata-compatibility.md9.4 KB
  • references/error-handling/path-validation.md7.5 KB
  • references/error-handling/spdx-validation.md8.2 KB
  • references/error-handling/version-validation.md8.8 KB
  • references/error-handling/wheel-file-selection.md8.7 KB
  • references/file-selection/force-include-option.md9.5 KB
  • references/file-selection/git-style-globs.md6.5 KB
  • references/file-selection/include-exclude-patterns.md6.9 KB
  • references/file-selection/index.md3.1 KB
  • references/file-selection/only-include-option.md7.2 KB
  • references/file-selection/packages-option.md7.9 KB
  • references/file-selection/pattern-precedence.md8.2 KB
  • references/file-selection/sources-option.md8.3 KB
  • references/integration/cmake-scikit-build.md10.2 KB
  • references/integration/extension-modules.md10.8 KB
  • references/integration/index.md2.1 KB
  • references/integration/legacy-setup-py.md9.8 KB
  • references/integration/pep-standards.md9.6 KB
  • references/integration/setuptools-compatibility.md9.1 KB
  • references/metadata-hooks/custom-hooks.md9.4 KB
  • references/metadata-hooks/index.md2.2 KB
  • references/metadata-hooks/metadata-hooks.md5.2 KB
  • references/plugins/build-hook-plugins.md10.4 KB
  • references/plugins/builder-plugins.md7.9 KB
  • references/plugins/hatch-vcs-plugin.md8.7 KB
  • references/plugins/index.md8.1 KB
  • references/plugins/metadata-hook-plugins.md10.8 KB
  • references/plugins/PLUGIN-GUIDE.md10.3 KB
  • references/plugins/version-scheme-plugins.md8.2 KB
  • references/plugins/version-source-plugins.md9.6 KB
  • references/project-metadata/basic-metadata.md4.1 KB
  • references/project-metadata/custom-hooks.md421 B
  • references/project-metadata/dependencies.md5.0 KB
  • references/project-metadata/direct-references.md5.9 KB
  • references/project-metadata/dynamic-metadata.md3.1 KB
  • references/project-metadata/entry-points-cli.md2.9 KB
  • references/project-metadata/entry-points-gui.md2.7 KB
  • references/project-metadata/entry-points-plugins.md4.1 KB
  • references/project-metadata/index.md3.8 KB
  • references/project-metadata/keywords-classifiers.md5.8 KB
  • references/project-metadata/licenses.md1.6 KB
  • references/project-metadata/metadata-hooks.md454 B
  • references/project-metadata/metadata-options.md2.1 KB
  • references/project-metadata/ownership.md4.0 KB
  • references/project-metadata/urls.md3.0 KB
  • references/project-metadata/version-specifiers.md6.9 KB
  • references/release-notes/BUILD_HOOKS_AND_PERFORMANCE.md10.5 KB
  • references/release-notes/index.md13.1 KB
  • references/release-notes/INDEX.md.backup11.8 KB
  • references/release-notes/METADATA_HOOKS_AND_VERSION_SOURCES.md8.4 KB
  • references/release-notes/PEP_639_LICENSE_METADATA.md6.0 KB
  • references/release-notes/RELEASE_NOTES.md23.5 KB
  • references/sdist-target/core-metadata-versions.md7.2 KB
  • references/sdist-target/index.md7.3 KB
  • references/sdist-target/legacy-setup-py.md7.6 KB
  • references/sdist-target/reproducible-builds.md9.8 KB
  • references/sdist-target/unix-socket-handling.md7.5 KB
  • references/sdist-target/vcs-integration.md9.9 KB
  • references/special-config/extension-module-loading.md11.1 KB
  • references/special-config/index.md3.8 KB
  • references/special-config/namespace-packages.md8.9 KB
  • references/special-config/package-name-normalization.md7.4 KB
  • references/special-config/pep-561-type-hinting.md5.1 KB
  • references/special-config/single-module-layout.md10.5 KB
  • references/special-config/spdx-license-metadata.md6.6 KB
  • references/special-config/src-layout-structure.md9.2 KB
  • references/standards/core-metadata.md10.5 KB
  • references/standards/dependency-formats.md9.5 KB
  • references/standards/distribution-formats.md9.5 KB
  • references/standards/index.md8.9 KB
  • references/standards/pep-references.md10.3 KB
  • references/standards/python-packaging-overview.md4.5 KB
  • references/standards/vcs-integration.md7.5 KB
  • references/target-config/config-precedence.md8.7 KB
  • references/target-config/default-targets.md7.4 KB
  • references/target-config/feature-dependencies.md8.6 KB
  • references/target-config/index.md3.1 KB
  • references/target-config/runtime-dependencies.md8.4 KB
  • references/target-config/target-dependencies.md6.9 KB
  • references/target-config/target-specific-hooks.md7.5 KB
  • references/target-config/versions-option.md8.7 KB
  • references/version-management/code-version-source.md10.4 KB
  • references/version-management/dynamic-version-overview.md9.0 KB
  • references/version-management/env-version-source.md11.6 KB
  • references/version-management/index.md5.1 KB
  • references/version-management/regex-version-source.md10.5 KB
  • references/version-management/search-paths.md11.9 KB
  • references/version-management/static-version.md6.7 KB
  • references/version-management/version-build-hook.md11.3 KB
  • references/version-management/version-cli.md9.1 KB
  • references/version-management/version-schemes.md10.0 KB
  • references/version-management/version-source-interface.md12.6 KB
  • references/version-management/version-validation.md11.9 KB
  • references/wheel-target/bypass-selection.md7.8 KB
  • references/wheel-target/core-metadata-versions.md3.8 KB
  • references/wheel-target/editable-wheels.md8.4 KB
  • references/wheel-target/extra-metadata.md8.4 KB
  • references/wheel-target/file-selection.md5.9 KB
  • references/wheel-target/force-include.md5.5 KB
  • references/wheel-target/index.md2.4 KB
  • references/wheel-target/macos-compat.md6.9 KB
  • references/wheel-target/package-discovery.md5.4 KB
  • references/wheel-target/shared-data.md6.6 KB
  • references/wheel-target/shared-scripts.md7.2 KB
  • references/wheel-target/sources-option.md9.1 KB
  • references/wheel-target/strict-naming.md6.4 KB
  • references/wheel-target/wheel-configuration.md3.1 KB
  • references/wheel-target/wheel-versioning.md9.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Load and follow the standards in /python-engineering:standards-for-python-development when applying shared architecture, typing, testing, or CLI rules.

  • 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 fields
  • references/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 installs
  • references/sdist-target/index.md - Sdist configuration, VCS integration, legacy setup.py support
  • references/build-targets/index.md - Wheel, sdist, binary, custom builders, multi-version builds
  • references/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-include
  • references/build-hooks/index.md - Hook interface, execution order, custom hooks, version hooks, build data passing
  • references/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 hooks
  • references/metadata-hooks/index.md - Metadata hook interface, custom hooks, dynamic metadata generation
  • references/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, isolation
  • references/integration/index.md - PEP standards compliance, setup.py migration, setuptools compatibility, CMake/extensions
  • references/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 builds
  • references/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 customization
  • references/error-handling/index.md - Path validation, file selection errors, version/license validation, heuristic failures
  • references/release-notes/index.md - Hatchling version history, feature additions, PEP 639 support, performance improvements

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

add-doc-updater

Free

Add automated documentation updater to any Claude skill. Creates a Python sync script that downloads upstream docs, processes markdown for AI consumption, and maintains local cache with configurable refresh. Collects template variables, then delegates implementation through 5-phase workflow. Use when adding auto-updating reference documentation to plugins or skills.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills67Updated Oct 20, 2026

add-new-feature

Free

SAM-style feature initiation workflow — discovery through codebase analysis, architecture spec, task decomposition, validation, and context manifest. Use when a user asks to add a feature, plan a feature, or convert an idea into an executable SAM plan.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills67Updated Oct 20, 2026

agent-browser

Free

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills67Updated Oct 20, 2026

agent-browser

Free

Browser automation for AI agents using the agent-browser CLI and Playwright. Use when navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, logging into sites, or automating any browser task. Triggers on "open a website", "fill out a form", "click a button", "scrape data", "test this web app", "automate browser actions", or any programmatic web interaction request.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills67Updated Oct 20, 2026

agent-capability-analyzer

Free

Runs the description-drift experiment — spawns all Claude Code agents simultaneously to collect self-reported capabilities, then compares them against static frontmatter descriptions to reveal how reliable orchestrator routing based on descriptions actually is. Use when measuring description drift across the agent fleet, re-running the capability collection experiment, analyzing a specific agent's self-reported capabilities, or auditing whether frontmatter descriptions accurately reflect agent behavior.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills67Updated Oct 20, 2026

agent-creator

Free

Create or adapt Claude Code agent definitions. Use when creating an agent, changing subagent configuration, selecting agent scope, or designing a specialized delegation role.

The English summary is being prepared. Showing the original description.

Jamie-BitFlight/claude_skills67Updated Oct 20, 2026

See all skills by Jamie-BitFlight

Report a problem with this skill