hermit-tooling

Activate the Hermit environment to expose repo-pinned binaries on PATH.

49|15|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/block/proto-fleet --skill hermit-tooling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermit-tooling
Source: https://github.com/block/proto-fleet/tree/main/.claude/skills/hermit-tooling
Command: npx skills add https://github.com/block/proto-fleet --skill hermit-tooling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers who encounter command not found errors for tools pinned by Hermit and provides a streamlined way to activate the repo's toolchain.

Core Features & Use Cases

  • Hermit-based tool activation: ensures binaries under .hermit/ become available on PATH after sourcing the activation script.
  • Avoids system-wide installs by using pinned versions and in-repo tools.
  • Use case: when a tool like just or golangci-lint prints command not found, run the activation step to resolve it and continue the workflow.

Quick Start

Source bin/activate-hermit to activate the environment and verify that a tool resolves to the repo's binaries.

Frequently Asked Questions about hermit-tooling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix command not found errors for Hermit tools like just or golangci-lint?

To fix command not found errors for Hermit tools, source the bin/activate-hermit activation script to update PATH and expose repo-pinned binaries. This makes tools like just and golangci-lint available within your repository context.

How does Hermit tool activation make repo-pinned binaries available?

Hermit tool activation works by sourcing an activation script that updates your PATH variable, seamlessly exposing binaries stored under the .hermit directory. This ensures your shell uses the exact pinned versions defined by the repo.

Do I need a .hermit directory to use this tool activation process?

Yes, you need a .hermit directory and its associated activation script present in your repository. The activation process relies on sourcing this script to successfully load the pinned developer tools onto your system PATH.

How do I activate the Hermit environment to load developer tools step by step?

To activate the Hermit environment, source the bin/activate-hermit file located in your repository. After sourcing the script, verify that a developer tool like just correctly resolves to the repo's binaries instead of a system-wide install.

Why use Hermit tool activation instead of installing dev tools system-wide?

Using Hermit tool activation avoids system-wide installs by ensuring binaries under .hermit become available on PATH after sourcing the activation script. This enforces consistency by using pinned versions and in-repo tools across different environments.

What dev tools can I load by activating the Hermit environment?

By activating the Hermit environment, you can load common developer tools like just, buf, golangci-lint, and goimports. These tools are pinned within the repository and become available on your PATH after activation.