Skill

copier-bootstrap

Bootstrap new projects using Copier templates. Use when the user requests to create a new project, start a new service, or bootstrap from a template. Trigger phrases include "create a new project", "start a new [type] project", "bootstrap a [type]", or "create a new FastAPI/Lambda/CLI/React/etc project". Supports FastAPI services, RabbitMQ workers, CLI tools, React frontends, AWS Lambda functions, and Google Cloud Functions.

Install

npx claudepluginhub darkflib/skill-marketplace --plugin copier-bootstrap-plugin

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Bootstrap new projects using Copier templates with consistent conventions and proper setup.

Supporting Assets

references/templates.mdscripts/list_templates.pyscripts/run_copier.py

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

163.7k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

163.7k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

163.7k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitMar 25, 2026

Actions

View Source View Plugin View on GitHub View README

Copier Bootstrap Skill

Bootstrap new projects using Copier templates with consistent conventions and proper setup.

Quick Start

When the user requests a new project:

Determine project type - Either from explicit request or by offering choices
Consult templates registry - Read references/templates.md to get template URL
Choose destination path - Confirm or suggest based on project naming
Run copier - Use scripts/run_copier.py with sensible defaults
Read AGENTS.md - After bootstrapping, read the template's AGENTS.md for conventions
Apply initial customization - Make any requested changes following template conventions

Detailed Workflow

Step 1: Determine Project Type

If the user specifies a project type explicitly (e.g., "Create a new FastAPI project"), proceed directly with that type.

Otherwise, list available project types using scripts/list_templates.py:

python scripts/list_templates.py

Present the options and ask the user to choose.

Step 2: Get Template URL

Read references/templates.md to find the template URL for the chosen project type. The file contains a table mapping project types to their template repositories.

Step 3: Determine Destination Path

Ask the user for the destination path, or suggest a sensible default based on:

Project type (e.g., ./my-fastapi-service)
Any naming conventions the user mentions
Current working directory context

Step 4: Bootstrap the Project

Run copier using the provided script:

python scripts/run_copier.py <template-url> <destination-path>

The script automatically:

Uses --trust to allow Jinja extensions
Uses --defaults to accept default answers
Creates the project with sensible defaults

If the user provides an answers file:

python scripts/run_copier.py <template-url> <destination-path> --answers-file answers.yml

If the user wants to override specific values:

python scripts/run_copier.py <template-url> <destination-path> --data project_name=my-service --data author=Mike

Step 5: Read Template Conventions

After successful bootstrapping, immediately read the generated project's AGENTS.md file:

cat <destination-path>/AGENTS.md

This file contains:

Project-specific conventions
Naming patterns
Architecture guidance
Development workflows
Testing approaches

Apply these conventions in any subsequent modifications or additions to the project.

Step 6: Initial Customization

If the user requested specific customization during creation:

Follow the conventions from AGENTS.md
Make changes that align with the template's structure
Maintain consistency with the template's patterns

Maintaining Templates

The templates registry is stored in references/templates.md. To update:

Edit the table to add/modify template URLs
Ensure each template has an AGENTS.md file for conventions
Test the template by bootstrapping a sample project

Scripts Reference

`scripts/run_copier.py`

Main script for running copier with proper arguments.

Features:

Automatic --trust flag for Jinja extensions
Default answers mode for quick bootstrapping
Support for answers files
Inline data overrides

`scripts/list_templates.py`

Display available project types from the registry.

Usage:

python scripts/list_templates.py

Common Patterns

Quick Bootstrap with Defaults

# User: "Create a new FastAPI project"
python scripts/list_templates.py  # Verify template exists
python scripts/run_copier.py gh:darkflib/fastapi-template ./my-service
cat ./my-service/AGENTS.md  # Read conventions

Bootstrap with Custom Answers

# User provides answers file
python scripts/run_copier.py gh:darkflib/fastapi-template ./my-service --answers-file my-answers.yml

Interactive Template Selection

# User: "Create a new project"
python scripts/list_templates.py  # Show options
# User selects type
python scripts/run_copier.py <template-url> ./my-project

Error Handling

If copier fails:

Check that copier is installed: pip install copier
Verify template URL is accessible
Ensure destination path is valid
Check for network connectivity (for remote templates)

If AGENTS.md is missing:

Proceed with generic Python/Node conventions
Suggest adding AGENTS.md to the template

Template Requirements

For optimal use, templates should include:

AGENTS.md - Conventions for AI agents
copier.yml - Template configuration
Sensible defaults for all questions
Working initial state that can be tested immediately