How do I install the Bootstrap Project skill?

Run npx skillmds@latest add joseluisamado/bootstrap-project in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bootstrap Project safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bootstrap Project?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bootstrap Project free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bootstrap Project?

joseluisamado (@joseluisamado) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bootstrap Project by joseluisamado — Agent Skill

Name: Bootstrap Project
Author: joseluisamado

Bootstrap Project

Crystallize a project-design conversation into a complete project scaffold. Reads the current session for project name, principles, milestones, stack, and audience; writes the docs/ quintet (PROJECT, ARCHITECTURE, ROADMAP, PROGRESS, DEPLOY), CLAUDE.md, Makefile, CI workflow, pre-commit config, VERSION, LICENSE, CHANGELOG, and supporting files. Supports stack profiles for Python, Node, Go, Rust, polyglot, and Nix flakes; deploy models for docker-compose, single binaries, artifacts (OS images / appliances), and libraries. Use this when the user says "bootstrap this project", "scaffold the repo", "now write all of this down", or invokes /bootstrap-project. The skill is a finalizer — it assumes the design conversation has happened in this session and extracts spec from context. It will ask only the minimum follow-ups (license, optional add-ons, profile-specific questions, anything missing). Do NOT use this for: existing projects (the skill refuses to clobber files); greenfield brainstorming (have the design conve

joseluisamado 771e526 83 files · 202.4 KB Updated Sep 17, 2026

File contents

bootstrap-project

This skill produces a project scaffold whose shape comes from libreta's engineering conventions, refined and extended.

The full playbook lives in INSTRUCTIONS.md. Read it when the skill is invoked. The short version:

Extract a project spec from the current conversation.
Print it; ask the user to confirm or correct.
Ask explicitly: license, optional add-ons, profile-specific questions.
Write the scaffold using templates/. Skip files that already exist.
Generate BOOTSTRAP-MANIFEST.md and .bootstrap-meta.yaml.
Print the "next 30 minutes" punch list.

The skill is same-session only. If invoked cold (no prior design conversation in this session), refuse with a message asking the user to either have the design conversation first or paste a summary.

The skill never writes outside the project root and never clobbers existing files.

Stack profiles

python-only, node-only, python+node, go-only, rust-only, polyglot
nix-flake — NixOS-based projects; see patterns/appliance-nixos.md.
none-yet — stack-agnostic scaffold.

Deploy models

docker-compose — standard service stack.
single-binary — one process, one binary.
artifacts — OS images, appliance models, anything where the deliverable is one or more built artifacts plus a config repo.
library — docs/PUBLISH.md instead of docs/DEPLOY.md.
none-yet.

For background on why the scaffold has its shape, see patterns/why-libreta-shape.md.

See CHANGELOG.md for version history and MIGRATIONS.md for upgrade notes between skill versions.

---name: bootstrap-projectdescription: Crystallize a project-design conversation into a complete project scaffold. Reads the current session for project name, principles, milestones, stack, and audience; writes the docs/ quintet (PROJECT, ARCHITECTURE, ROADMAP, PROGRESS, DEPLOY), CLAUDE.md, Makefile, CI workflow, pre-commit config, VERSION, LICENSE, CHANGELOG, and supporting files. Supports stack profiles for Python, Node, Go, Rust, polyglot, and Nix flakes; deploy models for docker-compose, single binaries, artifacts (OS images / appliances), and libraries. Use this when the user says "bootstrap this project", "scaffold the repo", "now write all of this down", or invokes /bootstrap-project. The skill is a finalizer — it assumes the design conversation has happened in this session and extracts spec from context. It will ask only the minimum follow-ups (license, optional add-ons, profile-specific questions, anything missing). Do NOT use this for: existing projects (the skill refuses to clobber files); greenfield brainstorming (have the design conve---# bootstrap-projectThis skill produces a project scaffold whose shape comes from libreta'sengineering conventions, refined and extended.The full playbook lives in [`INSTRUCTIONS.md`](./INSTRUCTIONS.md). Read itwhen the skill is invoked. The short version:1. Extract a project spec from the current conversation.2. Print it; ask the user to confirm or correct.3. Ask explicitly: license, optional add-ons, profile-specific questions.4. Write the scaffold using `templates/`. Skip files that already exist.5. Generate `BOOTSTRAP-MANIFEST.md` and `.bootstrap-meta.yaml`.6. Print the "next 30 minutes" punch list.The skill is **same-session only**. If invoked cold (no prior designconversation in this session), refuse with a message asking the user toeither have the design conversation first or paste a summary.The skill **never writes outside the project root** and **never clobbersexisting files**.## Stack profiles- `python-only`, `node-only`, `python+node`, `go-only`, `rust-only`, `polyglot`- `nix-flake` — NixOS-based projects; see [`patterns/appliance-nixos.md`](./patterns/appliance-nixos.md).- `none-yet` — stack-agnostic scaffold.## Deploy models- `docker-compose` — standard service stack.- `single-binary` — one process, one binary.- `artifacts` — OS images, appliance models, anything where the deliverable is one or more built artifacts plus a config repo.- `library` — `docs/PUBLISH.md` instead of `docs/DEPLOY.md`.- `none-yet`.For background on why the scaffold has its shape, see[`patterns/why-libreta-shape.md`](./patterns/why-libreta-shape.md).See [`CHANGELOG.md`](./CHANGELOG.md) for version history and[`MIGRATIONS.md`](./MIGRATIONS.md) for upgrade notes between skill versions.

Frequently asked questions