jamie-bitflight/hatchling
plugins/python3-development/skills/hatchling/SKILL.md
Use when working with Hatchling — configuring build system setup, pyproject.toml metadata, dependencies, entry points, build hooks, version management, wheel and sdist builds, package distribution, setuptools migration, or troubleshooting Hatchling build errors. Covers PEP 517/518/621/660 standards.
$ install --global
skillsauthnpx skillsauth add jamie-bitflight/claude_skills hatchlingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 28, 2026, 2:19 PM263.4s88 files scanned
SKILL.md
- name:
- hatchling
- description:
- Use when working with Hatchling — configuring build system setup, pyproject.toml metadata, dependencies, entry points, build hooks, version management, wheel and sdist builds, package distribution, setuptools migration, or troubleshooting Hatchling build errors. Covers PEP 517/518/621/660 standards.
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
Related Skills
jamie-bitflight/xdg-base-directory
development
VerifiedTrustedCommunity
When an application needs to store config, data, cache, or state files. When designing where user-specific files should live. When code writes to ~/.appname or hardcoded home paths. When implementing cross-platform file storage with platformdirs.
39SKILL.mdUpdated Apr 30, 2026
jamie-bitflight/verification-gate
testing
VerifiedTrustedCommunity
Enforce mandatory pre-action verification checkpoints to prevent pattern-matching from overriding explicit reasoning. Use this skill when about to execute implementation actions (Bash, Write, Edit) to verify hypothesis-action alignment. Blocks execution when hypothesis unverified or action targets different system than hypothesis identified. Critical for preventing cognitive dissonance where correct diagnosis leads to wrong implementation.
39SKILL.mdUpdated Apr 30, 2026
jamie-bitflight/twelve-factor-app
tools
VerifiedTrustedCommunity
Reference guide for the Twelve-Factor App methodology — 15 principles (12 original + 3 modern extensions) for building portable, resilient, cloud-native applications. Use when evaluating application architecture, designing cloud-native services, reviewing codebases for methodology compliance, advising on configuration, scaling, observability, security, and deployment patterns. Incorporates the 2025 open-source community evolution and cloud-native reinterpretations of each factor.
39SKILL.mdUpdated Apr 30, 2026
jamie-bitflight/user-docs-to-ai-skill
tools
VerifiedTrustedCommunity
Converts user-facing documentation (how-to guides, tutorials, API references, examples) in any format — Markdown, PDF, DOCX, PPTX, XLSX, AsciiDoc, RST, HTML, Jupyter notebooks, man pages, TOML/YAML/JSON configs, and plain text — into Claude Code skill directories with SKILL.md plus thematically grouped references/*.md files. Use when given a docs directory or mixed-format documentation to transform into an AI skill. Uses MCP file-reader server for binary formats.
39SKILL.mdUpdated Apr 30, 2026