project-agent-bootstrap

Creates minimal AGENTS.md and .codex/project.toml scaffolds connecting repositories to global agent systems.

2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/FluxonLab/Skillry --skill project-agent-bootstrap-fluxonlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-agent-bootstrap
Source: https://github.com/FluxonLab/Skillry/tree/main/plugins/core-operations/skills/89-project-agent-bootstrap
Command: npx skills add https://github.com/FluxonLab/Skillry --skill project-agent-bootstrap-fluxonlab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Repositories without project-local agent guidance cause AI coding agents to make wrong assumptions about package managers, build commands, and test runners, wasting context and introducing errors. This Skill inspects a repo, identifies guidance gaps, and creates a minimal scaffold that references global skills by name instead of copying them. ## Core Features & Use Cases - Guidance Inventory and Gap Analysis: Detects existing AGENTS.md, CLAUDE.md, GEMINI.md, .codex/project.toml, lockfiles, and framework markers before proposing any changes. - Minimal Scaffold Generation: Creates a concise AGENTS.md with package manager, key commands, safety constraints, and a machine-readable .codex/project.toml manifest with validated TOML syntax. - Context Engineering Reference: Includes absorbed guidance on session context setup, rules file hierarchy, and recovery when agent output quality degrades. - Use Case: When starting work on a medium-sized Next.js repo with no agent instructions, use this Skill to detect the pnpm lockfile, confirm scripts from package.json, and generate an AGENTS.md plus project.toml that point every future agent at the right commands and a curated set of at most seven skills and three agents. ## Quick Start Ask the agent to inspect this repository for existing agent guidance and propose a minimal AGENTS.md and .codex/project.toml scaffold before creating any files.

Frequently Asked Questions about project-agent-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up AGENTS.md for a Codex coding agent?▼

An AGENTS.md should include the package manager confirmed from the lockfile, install/dev/build/test/lint commands from package.json scripts, brief architecture notes, environment variable rules, safety constraints, and a final-report format. Keep it repo-specific rather than generic advice.

What is a .codex/project.toml file used for?▼

The .codex/project.toml is a machine-readable manifest declaring project type, package manager, framework, active skills, active agents, verification commands, env files, and known risks. Validate it after writing with python3 tomllib to confirm it parses.

Should I copy global skill files into my project?▼

No. Copying global skill bodies into .codex/skills/ creates a maintenance fork that drifts when the global skill updates. Reference global skills and agents by name in AGENTS.md and project.toml instead, creating local skills only for project-specific workflows.

How many skills and agents should a project activate?▼

Select at most seven skills and three agents based on what the project actually needs. Over-selecting floods the agent with context and degrades output quality; a Python API project does not need frontend skills.

When should I not create an agent scaffold?▼

Skip scaffolding for small one-off edits where existing guidance suffices, throwaway prototypes with no recurring agent workflow, or when the user has not approved file creation. Always propose the scaffold and wait for confirmation before writing files.

Why does my AI agent keep using the wrong package manager?▼

Agents default to global assumptions when no project-local guidance exists. Confirm the package manager from the lockfile (pnpm-lock.yaml, package-lock.json, yarn.lock) and write it explicitly in AGENTS.md so agents stop rewriting lockfiles incorrectly.