setup-dev-and-contributing

Scaffolds a repo's DEVELOPMENT.md spec and docs/contributing pages from seed templates.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/peachest/skills --skill setup-dev-and-contributing-peachest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-dev-and-contributing
Source: https://github.com/peachest/skills/tree/main/in-progress/setup-dev-and-contributing
Command: npx skills add https://github.com/peachest/skills --skill setup-dev-and-contributing-peachest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New or forked repositories often lack clear development specs and contributing guides, leaving contributors and AI agents guessing about branch models, commit conventions, test gates, and review rules. This Skill generates both documentation sets in one guided pass, grounded in the repo's actual tooling and posture. ## Core Features & Use Cases - Development spec generation: Creates a root DEVELOPMENT.md covering branch/remote model, internal-change markers, upstream sync strategy, design records, versioning, and code-style guards, following the internal-fork pattern. - Contributing docs scaffolding: Writes four docs/contributing pages (index with routing, development setup, workflow and reviews, testing and documentation) modeled on the NeMo Relay structure. - Posture-aware conditionality: Detects whether the repo is upstream OSS, an internal fork, or internal-only from git remotes, and keeps or strips fork-specific sections accordingly. - Use Case: After forking an upstream project internally, run this once to produce a DEVELOPMENT.md with commit-prefix and anchor-comment rules plus a complete docs/contributing/ set, then wire pointers into AGENTS.md so future agents auto-load them. ## Quick Start Ask the agent to set up the development spec and contributing docs for this repository.

Frequently Asked Questions about setup-dev-and-contributing

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

FAQPage Schema
How do I create a DEVELOPMENT.md and contributing docs for a new repo?▼

Run this Skill once per repo. It explores your git remotes, tooling, and existing docs, asks about repo posture and content specifics, then writes a root DEVELOPMENT.md plus four pages under docs/contributing/ adapted from seed templates.

What goes in DEVELOPMENT.md versus CONTRIBUTING docs?▼

The split is by when content is used: submit-time commands and gates (lint, tests, MR flow, review rules) go in docs/contributing/, while principles applied while writing code (branch model, change markers, upstream sync, design records) go in DEVELOPMENT.md.

Does it support internal forks of upstream open source projects?▼

Yes. Repo posture is detected from git remotes, and internal forks keep fork-specific sections: commit-prefix markers, anchor comments, upstream sync strategy, design records, and internal versioning. Upstream OSS or internal-only repos have those sections stripped.

How do AI agents find the generated documentation?▼

The Skill adds pointer blocks to AGENTS.md or CLAUDE.md so the docs auto-load for future agents. If neither file exists, it asks which to create rather than silently skipping, since without an entry file nothing loads the docs.

When should I re-run the documentation scaffolding?▼

Re-run only to restructure the documentation set. The generated files are meant to be edited directly afterward; the Skill is designed as a one-time-per-repo, on-demand setup rather than a continuous sync tool.