kdoronin/project-agent-bootstrap
project-agent-bootstrap/SKILL.md
Bootstrap new or existing local projects for AI-assisted development by creating an `AGENTS.md` for Codex or a `CLAUDE.md` for Claude Code from the bundled rules template, wiring project-local MCP servers for Playwright and shadcn/ui, and initializing Git with a first checkpoint commit when needed. Use whenever the user asks to start a project with agent instructions, scaffold a repo for Codex or Claude Code, add local MCP servers to a project, or standardize an AI-ready project workspace before implementation begins.
$ install --global
skillsauthnpx skillsauth add kdoronin/claude_code_skills project-agent-bootstrapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 11:02 AM3.9s4 files scanned
SKILL.md
- name:
- project-agent-bootstrap
- description:
- Bootstrap new or existing local projects for AI-assisted development by creating an `AGENTS.md` for Codex or a `CLAUDE.md` for Claude Code from the bundled rules template, wiring project-local MCP servers for Playwright and shadcn/ui, and initializing Git with a first checkpoint commit when needed. Use whenever the user asks to start a project with agent instructions, scaffold a repo for Codex or Claude Code, add local MCP servers to a project, or standardize an AI-ready project workspace before implementation begins.
Project Agent Bootstrap
Overview
Use this skill to turn a plain folder into an AI-ready project workspace. It writes the main instruction file from the bundled template, configures local MCP servers for the selected runtime, and bootstraps Git safely.
Quick Start
Run the bootstrap script first:
python3 ./project-agent-bootstrap/scripts/bootstrap_project.py \
--project-root /absolute/path/to/project \
--agent codex
Valid --agent values:
codex: createAGENTS.mdand.codex/config.tomlclaude: createCLAUDE.md,.mcp.json, and.claude/settings.local.jsonboth: create both instruction files and both runtime configsauto: infer runtime from the existing project; default tocodex
Workflow
- Decide which runtime the project needs: Codex, Claude Code, or both.
- Run
scripts/bootstrap_project.pywith the target project root. - Review the generated instruction file and keep the bundled policy intact unless the user explicitly wants changes.
- If the project already had local config, keep the merged result. Do not strip user-defined MCP entries.
- Continue implementation inside the bootstrapped repo.
Output Contract
Generate these files:
AGENTS.mdorCLAUDE.md: copy the bundled template from references/instruction-template.md.codex/config.toml: add project-localplaywrightandshadcnservers for Codex.mcp.json: add project-localplaywrightandshadcnservers for Claude Code.claude/settings.local.json: enable project MCP servers for Claude Code.gitignore: create a minimal bootstrap ignore file when the repo is new.git: initialize a Git repository if missing and create an initial commit when possible
Guardrails
- Do not hard-delete replaced files. The script moves overwritten instruction files into
.ai-bootstrap-trash/. - Merge existing
.mcp.json,.claude/settings.local.json, and.codex/config.tomlinstead of replacing them wholesale. - Keep the package-version rule in the generated instruction file: every external package and library version must be checked on the internet before installation or update.
- Do not claim UI work is done just because code compiles. The generated instruction file already requires Playwright MCP verification for UI projects.
Resources
- Use scripts/bootstrap_project.py for deterministic project setup.
- Read references/instruction-template.md only if you need to inspect or adjust the bundled rules text.
Example Prompts
- "Create a new Codex-ready Next.js project here and set up
AGENTS.mdwith local Playwright and shadcn MCP." - "Bootstrap this repo for Claude Code with
CLAUDE.mdand project-local MCP servers." - "Standardize this existing folder for AI agents before we start building."
Related Skills
kdoronin/text-to-sql
data-ai
VerifiedTrustedCommunity
Setup and use text-to-SQL capabilities for SQL databases (SQLite, PostgreSQL, MySQL, MariaDB, etc.). Use when: (1) User wants to query databases using natural language, (2) User asks to setup text-to-sql project, (3) User mentions extracting data from database, (4) User has .sqlite/.db file or database credentials and wants to work with data. This skill sets up project structure, extracts database schema, and enables natural language to SQL conversion.
22SKILL.mdUpdated Apr 6, 2026
kdoronin/strava-api
development
VerifiedTrustedCommunity
Universal Strava API integration for fitness data management. Use when working with Strava activities, athlete profiles, segments, routes, clubs, or any fitness tracking data. Triggers on requests to get/create/update activities, analyze training stats, export routes, explore segments, or interact with Strava data programmatically.
22SKILL.mdUpdated Apr 6, 2026
kdoronin/skill-orchestrator
development
VerifiedTrustedCommunity
This skill orchestrates programming tasks by analyzing available Claude Code skills and creating execution plans. It should be used when working on any coding task that could benefit from multiple specialized skills. The skill supports two execution modes selected by user - manual (Claude executes with explicit skill references) or delegated (tasks sent to sub-agents with skills).
22SKILL.mdUpdated Apr 6, 2026
kdoronin/skill-template
development
VerifiedTrustedCommunity
Template for creating Claude Code skills. Replace this description with a clear explanation of what this skill does and when it should be used. Be specific about triggers and use cases.
22SKILL.mdUpdated Apr 6, 2026