agentleFS
dominionthedevdominionthedev/skills/project-forge/SKILL.md

project-forge

Skill1 starsChanged 6 months agoMITView on GitHub

Instantly scaffolds production-ready project structures with all boilerplate, configs, CI/CD, and conventions pre-wired. Use this skill whenever someone wants to start a new project, app, service, CLI tool, or any codebase from scratch. Triggers on: "create a new project", "scaffold a", "start a Next.js/Go/Rust/Flutter app", "bootstrap", "init a project", "set up a new repo", "new service", or any request to begin building something new. Don't ask what stack to use if context is clear — infer it and scaffold immediately. Supports: Next.js, Astro, Astro+Starlight, Go service, Go CLI, Rust CLI, Rust service, Flutter. Always run the scaffold script FIRST before writing any code.

  • Reads credentials
  • Installs packages

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. Wamikmk/project-forge★ 2same name
    2. FiretrUCK666/project-forge★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository5 other files it gives its agents.

The file

Files
SKILL.md

Project Forge — Instant Project Scaffolding

You scaffold production-ready projects in seconds. Before writing a single line of code, you run the scaffold script to lay the entire foundation, then build on top of it.


Workflow

Step 1 — Run the scaffold script

python skills/project-forge/scripts/scaffold.py <type> <project-name> --output <dir>

Types:

TypeWhat you get
nextjsNext.js 14 App Router + Tailwind + Framer Motion + TypeScript strict
astroAstro 4 + Tailwind + View Transitions
go-serviceGo + Chi router + structured logging + graceful shutdown + Makefile
go-cliGo + Cobra + Viper config + Makefile
rust-cliRust + Clap + Tokio + Anyhow + Tracing
rust-serviceRust + Axum + SQLx + JWT + Tokio
flutterFlutter + Riverpod 2 + GoRouter + Material 3depreciated
# Examples
python scaffold.py nextjs my-saas --output ~/projects
python scaffold.py go-service payment-api --output ~/projects
python scaffold.py rust-cli file-watcher --output ~/projects

Step 2 — Parse the output

The script outputs JSON. Extract:

  • path — where files were created
  • files — list of all generated files
  • next_steps — commands to run immediately

Step 3 — Report to user and continue building

Tell the user exactly what was scaffolded, then immediately continue with the actual feature work they requested. Don't stop at the scaffold — that's just the launch pad.


What's included in each scaffold

nextjs

  • package.json with all prod + dev deps pinned
  • tsconfig.json (strict mode)
  • tailwind.config.ts with full CSS variable theme system
  • src/app/layout.tsx with next/font and metadata
  • src/app/page.tsx with Framer Motion entrance animation
  • src/app/globals.css with light + dark CSS variables
  • src/lib/utils.ts with cn() helper
  • .gitignore, .env.local, README.md

go-service

  • cmd/server/main.go with graceful shutdown
  • internal/server/server.go with Chi + CORS + middleware stack
  • internal/server/respond.go with JSON helpers
  • Makefile with dev/build/test/lint targets
  • .gitignore, README.md

rust-cli

  • Cargo.toml with clap, tokio, anyhow, tracing, serde
  • src/main.rs with derive-based CLI, subcommands, verbose flag
  • Release profile optimized (LTO, strip)
  • .gitignore, README.md

Post-scaffold checklist

After scaffolding, always:

  • Tell the user which files were created
  • Ask if you should continue
  • Show the next-steps commands
  • Implement the actual feature/app they asked for
  • Do NOT ask them to run the next steps themselves if you can do it

Important: Script location

The scaffold script is at:

skills/project-forge/scripts/scaffold.py

It requires only Python 3.10+ stdlib (no pip install needed).

NOTE: this skill is to be upgraded

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.