setup-agent-skills

Configure machine-wide agent-skills workflow settings and persist them to a JSON config file.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ambroselittle/agent-skills --skill setup-agent-skills-ambroselittle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-agent-skills
Source: https://github.com/ambroselittle/agent-skills/tree/main/skills/setup-agent-skills
Command: npx skills add https://github.com/ambroselittle/agent-skills --skill setup-agent-skills-ambroselittle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

First-time setup for agent-skills workflow. Configures where plans and reviews are stored and your personal branch prefix. Run this once per machine before using /plan-work, /do-work, or other workflow skills.

Core Features & Use Cases

  • Guides initial configuration of work folder, branch prefix, and optional Superset device discovery.
  • Writes final config to ~/.claude/agent-skills.json and makes it available to subsequent planning commands.
  • Supports re-use across multiple repos and sessions, ensuring persistence across branch deletions.

Quick Start

Run this once to configure your agent-skills workspace, including work folder, branch prefix, and saved config, then begin with /plan-work.

Frequently Asked Questions about setup-agent-skills

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

FAQPage Schema
How do I configure machine-wide settings for an agent workflow?

To configure machine-wide agent workflow settings, run a one-time setup process that guides you through selecting a work folder, defining a branch prefix, and optionally discovering a Superset device. It writes the final configuration to ~/.claude/agent-skills.json for subsequent commands to use.

Do I need to run setup before using planning and work commands?

Yes, you must run the setup once per machine before using planning and work commands. It establishes where your plans and reviews are stored and sets your branch prefix, ensuring the configuration persists across multiple repos, sessions, and branch deletions.

What is a branch prefix and why do I need it for my workflow configuration?

A branch prefix is a personal identifier configured during workflow setup to organize your development branches. It is saved to the configuration file so that subsequent planning and work commands can automatically apply it when creating new branches across different repositories.

Can I reuse my workflow configuration across multiple repositories and sessions?

Yes, the setup configuration is designed for reuse across multiple repos and sessions. By writing settings to a machine-wide configuration file, it ensures your work folder and branch prefix persist even after branch deletions or switching contexts.

How does Superset device discovery work during agent workflow setup?

Superset device discovery is an optional step during the one-time setup process. It guides you through finding and linking a Superset device to your workflow configuration before writing the final settings to the machine-wide configuration file.