# Project

> Use when asked to find a project, work on a project, start a feature, fix a bug, or make changes to a repo.

- Skill: `eddmann/project` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add eddmann/project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eddmann/project/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eddmann (https://skillmd.com/u/eddmann)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eddmann/project

---


# Project Manager

Primary repos stay clean on main in `$PROJECTS_HOME`. Working clones live in `$PROJECTS_CLONE_DIR/<project>/<clone>/`.

Use `${CLAUDE_SKILL_DIR}/scripts/project` for all commands.

## Workflow

0. **`list`** to find the project if you don't know the exact name
1. **`create`** a clone — never work in the primary repo directly
2. **`switch`** to get the clone path, then `cd` there
3. Work normally — edit files, commit often
4. Tell the user the clone is ready for review
5. The user will **`accept`** or **`discard`**

## Commands

```bash
# find projects
scripts/project list                                       # all projects and their clones
scripts/project list auth                                  # filter by name
scripts/project list --status active --limit 5

# clone lifecycle
scripts/project create <project> --name <name> --desc "what this work is for"
scripts/project create my-app                              # auto-generates name
scripts/project switch <project> <clone>                   # get clone path
scripts/project sync <project> <clone>                     # pull latest main into clone
scripts/project diff <project> <clone>                     # commits + diff vs main
scripts/project accept <project> <clone>                   # apply commits to primary
scripts/project discard <project> <clone>                  # delete clone
scripts/project cleanup [--stale-days 7]                   # purge finished clones
```

## Rules

1. **Never modify the primary repo directly** — always work in a clone
2. **Commit early and often** — these become the patches on accept
3. **One feature per clone** — keep work isolated
4. **Check `list` first** — a relevant clone may already exist