Agent skill

toolchain-health

Validate Python toolchain alignment between mise, Poetry, and pyproject. Use when changing Python versions, editing pyproject.toml, or seeing Poetry/mise version solver errors. Invokes /toolchain-health to check: - .mise.toml python tool version - pyproject.toml python constraint - Poetry env python interpreter Keywords: python version, mise, poetry, toolchain, env use, lock, install

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/stars-end/agent-skills/tree/master/toolchain-health

SKILL.md

Toolchain Health (Python + mise + Poetry)

Navigate and validate the Python toolchain configuration for this repo.

Canonical Policy

  • Exact version source of truth: .mise.toml
    • Example:
      toml
      [tools]
python = "3.11.8"
  • Compatible range in pyproject.toml:
    • Use a range that includes the mise version and allows patch bumps, e.g.:
      toml
      [tool.poetry.dependencies]
python = ">=3.11,<4.0"
  • Poetry env uses the mise-managed interpreter:
    • When (re)creating the env:
      bash
      poetry env use "$(mise which python)"
poetry lock
poetry install --only main
  • Upgrades:
    1. Update .mise.toml first and run mise install python.
    2. Run poetry env use "$(mise which python)".
    3. Only then tighten the python range in pyproject.toml if necessary.

Agents should avoid changing one layer (mise or pyproject) without considering the others.

Command: /toolchain-health

Use the /toolchain-health command (see .claude/commands/toolchain-health.md) to:

  1. Print Python from mise (mise which python + version).
  2. Show the python = ... constraint in pyproject.toml.
  3. Show the Python used by the Poetry env (if any).

When to Use This Skill

  • Editing .mise.toml to change Python versions.
  • Editing pyproject.toml to change the python constraint.
  • Seeing Poetry errors like:
    • "Current Python version is not allowed by the project"
    • Version solver failures related to python markers.
  • Before running poetry lock or poetry install as part of dependency or LLM infra work.

Agent Guidance

When this skill is relevant:

  1. Run /toolchain-health to gather the current state.
  2. Identify mismatches:
    • If .mise.toml and pyproject.toml disagree, recommend updating one to match the other, following the policy above.
    • If Poetry env uses a different interpreter than mise, recommend:
      bash
      poetry env use "$(mise which python)"
  3. Explain the root cause and suggest a minimal, coherent fix rather than ad-hoc changes.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

stars-end/agent-skills

parallelize-cloud-work

Delegate independent work to Claude Code Web cloud sessions for parallel execution. Generates comprehensive session prompts with context exploration guidance, verifies Beads state, provides tracking commands. Use when user says "parallelize work to cloud", "start cloud sessions", or needs to execute multiple independent tasks simultaneously, or when user mentions cloud sessions, cloud prompts, delegate to cloud, Claude Code Web, generate session prompts, parallel execution, or asks "how do I use cloud sessions".

0 0
Explore
stars-end/agent-skills

docs-create

Create epic-specific documentation skill with external reference docs. MUST BE USED for caching external docs. Fetches URLs, caches full content, uses documentation-engineer to generate cohesive summaries, and creates auto-activating skill. Use when starting work on epic that requires external documentation context (API docs, tool guides, reference materials), or when user mentions "cache docs", "external docs", "API documentation", URLs for docs, documentation needs, reference materials, knowledge caching, or epic context documentation.

0 0
Explore
stars-end/agent-skills

railway-doctor

0 0
Explore
stars-end/agent-skills

git-safety-guard

Installs a Git safety guard hook for Claude Code to prevent destructive Git and filesystem commands. Blocks accidental data loss from commands like 'git checkout --', 'git reset --hard', 'git clean -f', 'git push --force', and 'rm -rf'. Use this skill to set up safety rails in a new or existing repository, or globally for the agent.

0 0
Explore
stars-end/agent-skills

beads-guard

Safe Beads workflow helper (warning-only). Use before bd sync/close/create to avoid JSONL conflicts. Ensures you are on a feature branch, up to date with origin/master, and stages Beads files cleanly with Feature-Key commits.

0 0
Explore
stars-end/agent-skills

vm-bootstrap

Linux VM bootstrap verification skill. MUST BE USED when setting up new VMs or verifying environment. Supports modes: check (warn-only), install (operator-confirmed), strict (CI-ready). Enforces Linux-only + mise as canonical; honors preference brew→npm (with apt fallback). Verifies required tools: mise, node, pnpm, python, poetry, gh, railway, bd, tmux, jq, rg. Handles optional tools as warnings: tailscale, playwright, docker, bv. Never prints/seeds secrets; never stores tokens in repo/YAML; Railway vars only for app runtime env. Safe on dirty repos (refuses and points to dirty-repo-bootstrap skill, or snapshots WIP branch). Keywords: vm, bootstrap, setup, mise, toolchain, linux, environment, provision, verify, new vm

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results