hatchling
About
This skill provides comprehensive documentation for Hatchling, the modern Python build backend implementing PEP standards. Use it when configuring `pyproject.toml`, managing project metadata and dependencies, or troubleshooting build errors for wheel and sdist creation. It covers key capabilities like configuration, version management, build hooks, and migration from setuptools.
Quick Install
Claude Code
Recommended/plugin add https://github.com/Jamie-BitFlight/claude_skillsgit clone https://github.com/Jamie-BitFlight/claude_skills.git ~/.claude/skills/hatchlingCopy and paste this command in Claude Code to install this skill
Documentation
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
- 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
- Project Metadata & Configuration - Package metadata, dependencies, entry points, dynamic fields
- Build System Configuration - Build backend setup, PEP 517/518, reproducible builds, environment variables
Build Targets
- Wheel Build Target - Wheel configuration, package discovery, file selection, editable installs
- Source Distribution (Sdist) Target - Sdist configuration, VCS integration, legacy setup.py support
- Build Target Types - Wheel, sdist, binary, custom builders, multi-version builds
- Build Targets Configuration Details - Target-specific hooks, dependencies, versions, precedence
File Selection & Build Customization
- File Selection & Patterns - Git-style globs, include/exclude patterns, VCS integration, force-include
- Build Hooks - Hook interface, execution order, custom hooks, version hooks, build data passing
- Advanced Build Features - Dynamic dependencies, force-include, path rewriting, editable installs, build context
Version & Metadata Management
- Version Management - Version sources (code, regex, env), schemes, validation, build hooks
- Metadata Hooks - Metadata hook interface, custom hooks, dynamic metadata generation
- Context Formatting & Dynamic Configuration - Context variables, environment-based config, interpolation
Plugin System
- Plugin System & Extensibility - Builder, hook, metadata, version plugins, hatch-vcs, plugin development
Build Environment & Integration
- Build Environment Internals - Environment config, dependencies, UV vs pip, Cython integration, isolation
- Integration & Compatibility - PEP standards compliance, setup.py migration, setuptools compatibility, CMake/extensions
- Special Configuration Options - PEP 561 type hints, SPDX licenses, namespace packages, src-layout, extensions
Core Concepts & Standards
- Core Concepts & Best Practices - PEP 517 backend, minimal philosophy, VCS file selection, reproducible builds
- Related Standards & Specifications - Python packaging overview, PEP references, metadata specs, distribution formats
Operational Guides
- Command-Line Building - hatch build commands, python -m build, pip install, output customization
- Error Handling & Validation - Path validation, file selection errors, version/license validation, heuristic failures
- Release Notes & Version History - Hatchling version history, feature additions, PEP 639 support, performance improvements
GitHub Repository
Related Skills
content-collections
MetaThis skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.
langchain
MetaLangChain is a framework for building LLM applications using agents, chains, and RAG pipelines. It supports multiple LLM providers, offers 500+ integrations, and includes features like tool calling and memory management. Use it for rapid prototyping and deploying production systems like chatbots, autonomous agents, and question-answering services.
Algorithmic Art Generation
MetaThis skill helps developers create algorithmic art using p5.js, focusing on generative art, computational aesthetics, and interactive visualizations. It automatically activates for topics like "generative art" or "p5.js visualization" and guides you through creating unique algorithms with features like seeded randomness, flow fields, and particle systems. Use it when you need to build reproducible, code-driven artistic patterns.
webapp-testing
TestingThis Claude Skill provides a Playwright-based toolkit for testing local web applications through Python scripts. It enables frontend verification, UI debugging, screenshot capture, and log viewing while managing server lifecycles. Use it for browser automation tasks but run scripts directly rather than reading their source code to avoid context pollution.