mridun.gupta

project-init

agent skill · v1.0.0 · MIT · SKILL.md standard

One SKILL.md package that initializes any project to a universal documentation standard — works across IDEs, AI coding apps and model backends. When a new project is created, the agent will:

1 · git init
Branch main + a baseline .gitignore.
2 · docs of record
Drafts PRD.md, TRD.md and EXECUTED.md (append-only execution log) at the project root.
3 · knowledge base
Builds docs/ in four audience tracks — ai/, technical/, layman/, non-technical/ — with an index README.
4 · conventions
Drops AGENTS.md (+ CLAUDE.md / GEMINI.md pointers) so every future agent session keeps docs in sync automatically.
5 · full mode
Writes a README.md per folder and prepends a header comment to every source file — purpose, Docs: link, author, ISO-8601 timestamp.

Install

one line · auto-detects ~12 agents
npx skills add mridun-gupta/project-init.skills

# GitHub Copilot
gh skill add mridun-gupta/project-init.skills

# Claude Code (repo self-hosts a marketplace)
/plugin marketplace add mridun-gupta/project-init.skills

# Gemini CLI
gemini skills install https://github.com/mridun-gupta/project-init.skills

Vendor-neutral manual spot: copy skills/project-init/ into ~/.agents/skills/ (reaches Devin, Cursor, Codex, Copilot, Gemini CLI, Zed, Cline…) or <repo>/.agents/skills/ per-project. Full per-tool matrix: INSTALL.md.

Modes

/project-init
init (default) — full setup for a new project.
lite
Skeleton docs now; re-invoke upgrade later.
upgrade · full
Idempotent retrofit of an existing repo — fills gaps, never overwrites.

It always asks first — project name, one-line purpose, mode, author (defaults to git config user.name). Nothing is fabricated; unknowns become TODO markers.

What it produces

my-project/
├── PRD.md  TRD.md  EXECUTED.md       # documents of record
├── AGENTS.md                         # standing conventions
├── CLAUDE.md  GEMINI.md              # pointers → AGENTS.md
├── README.md  .gitignore  LICENSE
└── docs/
    ├── README.md                     # KB index
    └── ai/  technical/  layman/  non-technical/   # 4 seeded tracks

Works with

Claude Code · Codex CLI / ChatGPT desktop · Cursor · VS Code Copilot · Devin · Google Antigravity · Gemini CLI · Windsurf · Kiro · Amp · OpenCode · Zed · Cline · Roo — anything reading the open Agent Skills format. For tools without skill support (ChatGPT web, Grok, local models): paste skills/project-init/SKILL.md as a system prompt, or drop templates/AGENTS.md into the project.

Known limits: auto-invocation on "new project" phrasing depends on the host agent (manual /project-init always works); files that can't hold comments (JSON, lockfiles, binaries) get no header; full on very large repos asks you to scope.

Docs mirror — canonical source is the repo's README/INSTALL.