# project-bootstrap

This skill configures repository structure, checks, CI, and agent infrastructure. Use it for a new project or a repository prepared for distribution.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 794 installs
- Author: jssblck
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jssblck/agents/tree/HEAD/skills/project-bootstrap/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/project-bootstrap

## What it does

The skill chooses a setup scope: a minimal runnable project, repository tooling, distribution files, or Jess’s full template. It can add source layout, a dependency manifest, formatter, linter, type and build checks, CI, release files, and contributor guidance when the request calls for them.

Defaults vary by language. TypeScript uses `oxfmt`, `oxlint`, and `tsc --noEmit`; Python uses `ruff` with `mypy` or `pyright`; Rust uses `rustfmt`, `clippy`, and Cargo checks. New TypeScript applications can also receive the described Effect, schema, `xstate`, Vitest, and Postgres stack. Existing tooling stays in place unless migration is part of the task.

When requested, the skill adds agent rules, AI review gates, or hooks, then keeps CI and local checks on one shared recipe. A new project also needs a choice between AGPL-3.0-or-later and Apache-2.0 for its license.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill project-bootstrap -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/project-bootstrap/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/project-bootstrap/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill project-bootstrap -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/project-bootstrap/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill project-bootstrap -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/project-bootstrap/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jssblck/agents project-bootstrap
```

2. **Manually: put the files in place**
- File: `.github/skills/project-bootstrap/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill project-bootstrap -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jssblck/agents --path skills/project-bootstrap
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/project-bootstrap/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill project-bootstrap -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jssblck/agents/tree/HEAD/skills/project-bootstrap/SKILL.md

## When to use it
- create a new repository layout
- choose language-specific format and lint checks
- share one verification recipe between CI and local work
- add agent rules and an AI review gate
- prepare files for public distribution

## Example prompts
- Set up a new TypeScript repository with type checks, linting, and CI.
- Create a minimal runnable Python project with its dependency manifest and verification commands.
- Apply Jess’s full project template, including agent rules and release files.

## Similar
- [qa-project-bootstrap](https://affpapa.org/en/nevibecode/skills/qa-project-bootstrap.md) — skill · 1000 installs
- [bash-script-validator](https://affpapa.org/en/nevibecode/skills/bash-script-validator.md) — skill · 679 installs
- [kotlin-tooling-gradle-to-kotlin-toolchain-project](https://affpapa.org/en/nevibecode/skills/kotlin-tooling-gradle-to-kotlin-toolchain-project.md) — skill · 426 installs
- [Quality Gates](https://affpapa.org/en/nevibecode/skills/quality-gates.md) — skill · 536 installs
- [shellcheck-configuration](https://affpapa.org/en/nevibecode/skills/shellcheck-configuration.md) — skill · 11533 installs
- [agnix](https://affpapa.org/en/nevibecode/skills/agent-sh-agnix.md) — skill · ★ 458

From the same set: [jssblck/agents](https://affpapa.org/en/nevibecode/by/jssblck/agents.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md