setup-dev

Verifies and configures a developer's local environment against HERO.md requirements.

5|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ai-hero/hero-skills --skill setup-dev-ai-hero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-dev
Source: https://github.com/ai-hero/hero-skills/tree/main/skills/setup-dev
Command: npx skills add https://github.com/ai-hero/hero-skills --skill setup-dev-ai-hero

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New team members and fresh machines often lack the right CLI tools, git identity, and authentication needed by a project's workflow, causing confusing failures later. This Skill reads the team's HERO.md configuration and walks a developer through checking and fixing their local setup without touching any shared files. ## Core Features & Use Cases - Environment verification: Checks git config (identity, signing, remotes), required and recommended CLI tools, authentication status for gh/aws/gcloud/kubectl, and MCP server expectations against HERO.md. - Guided remediation: Suggests platform-appropriate install commands (brew, apt) and asks before changing any personal config like git identity or signing keys. - Check-only and recalibrate modes: Run with --check to audit without changes, or use recalibrate to tune the HERO.md fields this skill depends on. - Use Case: A developer clones the repo on a new laptop, runs the setup check, and gets a report showing gh is missing and AWS is not authenticated, with exact commands to fix both. ## Quick Start Ask the assistant to run the setup-dev skill to verify my local development environment against HERO.md and report anything missing.

Frequently Asked Questions about setup-dev

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

FAQPage Schema
How do I set up a new developer machine for a project?

Run the setup-dev skill, which reads the project's HERO.md and checks git config, required CLI tools, authentication, and MCP servers. It reports what is missing and suggests platform-appropriate install commands for macOS or Linux.

How to check if required CLI tools are installed for a project?

Use the --check flag to verify the environment without changing anything. The skill runs which and version checks for each tool listed in HERO.md and reports installed versions versus missing tools with install commands.

Does this skill modify my project's shared config files?

No, it never writes to HERO.md, CLAUDE.md, or any committed file. It only touches local git config after asking for confirmation, and suggests install or login commands for the developer to approve.

What happens if HERO.md is missing when running setup?

The skill stops and tells you to run the init-hero skill first to create the project configuration. The recalibrate argument is handled before this check so it can fill in the fields setup-dev reads.

Why does the skill ask before setting git identity?

Git user.name, user.email, and signing keys are personal settings that vary per developer and per machine. The skill presents current global and local values and only sets local config after explicit user confirmation.