# New Project

> Bootstrap a new project or experiment directory with README and optional `AGENTS.md` files. Use when the user asks to create a new project, start an experiment, add a workspace entry, scaffold a project folder, or bootstrap durable work in this personal monorepo.

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

---


# New Project

Create a project or experiment that agents can discover later.

## Workflow

1. Read root `AGENTS.md` and `README.md`.
2. Decide whether the work is a long-lived `project` or short-lived `experiment`.
3. Use a lowercase hyphenated slug. Experiments must use `exp-<topic>-YYYY-MM-DD`.
4. Run the helper when possible:

```sh
python .codex/skills/new-project/scripts/new_project.py "Project Name" --summary "One-line summary"
```

For an experiment:

```sh
python .codex/skills/new-project/scripts/new_project.py "Experiment Name" --type experiment --summary "One-line summary"
```

5. Add project-specific commands, data sources, and safety gates to the generated `AGENTS.md` if they matter.
## Output

Report the created folder and any missing fields that need human input.