project-add

Register new projects in a multi-project claude-config setup with symlinks.

Updated Jan 1, 2026
One-click install
npx skills add https://github.com/AirMile/claude-config --skill project-add
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-add
Source: https://github.com/AirMile/claude-config/tree/main/skills/project-add
Command: npx skills add https://github.com/AirMile/claude-config --skill project-add

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Registers a new project in a multi-project claude-config setup by creating per-project directories and linking to the shared claude-config resources (agents, hooks, skills, scripts) via symlinks or junctions.

Core Features & Use Cases

  • Adds a new project or clones an existing repository and configures per-project structure (.claude, .project directories).
  • Establishes appropriate symlinks/junctions to central config assets across macOS and Windows.
  • Guides through a multi-step interactive flow to select mode, project name, repository, profiles, and optional publish steps.

Quick Start

Run /project-add to start the interactive flow and register a new project in the multi-project claude-config setup.

Frequently Asked Questions about project-add

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

FAQPage Schema
How do I set up symlinks to share claude-config across multiple projects?

You can register a new project in a multi-project claude-config setup by creating per-project directories and linking to shared resources like agents, hooks, and skills via symlinks or junctions.

Can I clone an existing GitHub repository and configure it for claude-config?

Yes, the project setup flow clones an existing GitHub repository using gh CLI and configures the per-project structure, establishing symlinks to central config assets automatically.

Do I need the gh CLI to initialize a new project with shared claude-config resources?

Yes, gh CLI is required for cloning and publishing actions during project setup, ensuring the new project integrates correctly with the master claude-config repository.

Does the claude-config project setup work on both macOS and Windows?

Yes, the setup applies platform-specific path resolution via paths.yaml or environment variables, creating symlinks on macOS and junctions on Windows to link shared config resources.

What's the best way to manage shared agents and hooks across separate project directories?

Registering each project within a multi-project claude-config setup establishes links to shared agents, hooks, skills, and scripts, ensuring consistent configuration across all directories.

Why does project registration validate the master claude-config repository?

Validating the master claude-config repository ensures a stable setup before creating per-project directories and symlinks, preventing broken links to shared resources.