new-project

Scaffolds new projects with GitHub repos, Claude Code configuration, documentation templates, and live agent sessions.

Updated May 12, 2026
One-click install
npx skills add https://github.com/fryanpan/ai-team-lead --skill new-project-fryanpan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: new-project
Source: https://github.com/fryanpan/ai-team-lead/tree/main/.claude/skills/new-project
Command: npx skills add https://github.com/fryanpan/ai-team-lead --skill new-project-fryanpan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new project involves repetitive setup work: creating a GitHub repo, configuring Claude Code settings, writing documentation scaffolding, registering the project in a fleet registry, and launching an agent session. This Skill automates that entire sequence in one invocation so a new project goes from idea to a working repo with an agent already on the first task. ## Core Features & Use Cases - GitHub repo creation and cloning: Uses the gh CLI to create private repos and clone them to ~/dev/<project-name>, with support for local-only projects that skip git entirely. - Template-based scaffolding: Copies settings, gitignore, and documentation templates (learnings, retrospectives, decisions, vision, process) while writing an honest CLAUDE.md from actual project context rather than placeholder filler. - Registry and session handoff: Registers the project in registry.yaml with ship method and respawn settings, then spawns a tmux agent session and sends it the first task. - Use Case: You describe a new client advisory engagement in one message, and the Skill creates the private repo, scaffolds docs, registers it in the fleet, and starts an agent session drafting the initial analysis. ## Quick Start Ask the assistant to start a new project called my-app that is a Python CLI tool, and it will create the repo, scaffold the documentation, and spawn a working session.

Frequently Asked Questions about new-project

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

FAQPage Schema
How do I scaffold a new project with a GitHub repo and Claude Code config?▼

Invoke the new-project skill with a project name and short description. It creates a private GitHub repo via the gh CLI, clones it to ~/dev/<project-name>, copies settings and documentation templates, registers the project, and spawns an agent session on the first task.

What information do I need to provide when starting a new project?▼

Only the project name, what the project is, and the language or stack. Everything else defaults: private visibility, no Linear, ship-auto method, path under ~/dev, and respawn enabled. Defaults are stated so you can correct any of them.

Can I create a local-only project without a GitHub repo?▼

Yes. Local-only projects such as a synced Drive folder or scratch directory skip repo creation entirely. No repo field is added to the registry and no git commands are run.

Why does the skill use the gh CLI instead of the GitHub MCP plugin?▼

The GitHub MCP plugin is unreliable for private and newly created repos, as documented in the project's learnings file. The gh CLI handles repo creation and cloning consistently.

When should I not use this project scaffolding skill?▼

Skip it for one-off experiments that need no repo, documentation, or ongoing agent session. The skill is designed for projects that will be registered in the fleet and worked on over time.