project-setup

Generate project scaffolds with AGENTS.md, specs/, logs/, and config artifacts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/francojc/dotfiles --skill project-setup-francojc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-setup
Source: https://github.com/francojc/dotfiles/tree/main/.pi/agent/skills/project-setup
Command: npx skills add https://github.com/francojc/dotfiles --skill project-setup-francojc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold a complete, context-aware project structure from a brief project description, ensuring consistency and saving setup time.

Core Features & Use Cases

  • Generate AGENTS.md, specs/ (planning, progress, implementation), logs/, and environment templates from README.md or equivalent description.
  • Provide fork-mode support for development-focused projects, enabling additive fork contexts without altering upstream templates.
  • Produce standard config artifacts such as flake.nix and .gitignore to kickstart development workflows.

Quick Start

Provide a project description document (README.md or PROJECT.md) and run this skill to generate the full project scaffold.

Frequently Asked Questions about project-setup

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

FAQPage Schema
How do I scaffold a complete project structure from a brief description?

To scaffold a project, provide a README.md or PROJECT.md description and run the project-setup process to generate directories like AGENTS.md, specs/, logs/, and environment templates automatically.

Can I generate AGENTS.md and specs directories for a research project?

Yes, generating AGENTS.md and specs/ directories supports research, teaching, grant, service, or development projects by creating context-aware planning, progress, and implementation guides from your project description.

Does project scaffolding work with Nix flakes and .gitignore configs?

Yes, project scaffolding produces standard config artifacts such as flake.nix and .gitignore alongside template-driven planning guides to kickstart development workflows immediately.

What is fork-mode support in project scaffolding?

Fork-mode support enables additive fork contexts for development-focused projects without altering upstream templates, ensuring your scaffolded repository structure maintains upstream compatibility.

How do I set up a repository structure for multiple project types?

Setting up a repository structure for multiple project types requires a single project description document; the scaffold applies context-aware templates to generate directories for research, teaching, grant, service, or development workflows.

What files do I need to start automated project scaffolding?

You need a project description document, typically a README.md or PROJECT.md, to start automated project scaffolding and generate the complete directory structure with planning and config artifacts.