development-guidelines

Generate a development-guidelines spec page defining coding standards, toolchain, and testing rules for a repository.

Updated May 4, 2026
One-click install
npx skills add https://github.com/antstanley/skills --skill development-guidelines-antstanley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: development-guidelines
Source: https://github.com/antstanley/skills/tree/main/plugins/spec-creator/skills/development-guidelines
Command: npx skills add https://github.com/antstanley/skills --skill development-guidelines-antstanley

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams and AI agents working in a repository need a single authoritative statement of the coding discipline — toolchain, style, defensive coding, limits, version control, testing, and definition of done — but writing that page consistently across languages and styles is repetitive and error-prone. This Skill produces that page as a canonical spec document following spec-creator conventions. ## Core Features & Use Cases - Language detection and templates: Detects TypeScript, JavaScript, Rust, or Python from repo signals (Cargo.toml, tsconfig.json, pyproject.toml) and assembles per-language conventions from style-neutral base files. - Two coding styles: Renders the page in Tiger Style (defensive, assertion-heavy, limits everywhere) or Clean Code (readability-first, exceptions, small functions) using language-specific overlays. - VCS-aware sections: Detects jujutsu vs git and emits the matching version-control guidelines, preferring jj when both directories exist. - Use Case: A monorepo with a Rust backend and TypeScript frontend needs coding standards before development starts. The Skill detects both languages, confirms Tiger Style, and writes .specs/development-guidelines.md with toolchain tables, per-language conventions, AI-agent rules, and a definition of done, then indexes it in .specs/README.md. ## Quick Start Ask the AI to add a development-guidelines page to the spec at .specs/ for this repository using Tiger Style.

Frequently Asked Questions about development-guidelines

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

FAQPage Schema
How do I add coding standards to a spec-driven project?

Invoke the Skill with a request like "add development guidelines to the spec". It detects the repo's languages and VCS, asks you to choose Tiger Style or Clean Code, then writes .specs/development-guidelines.md with toolchain, conventions, testing rules, and a definition of done.

What is the difference between Tiger Style and Clean Code templates?

Tiger Style is a defensive discipline prioritizing safety with assertions, explicit limits, and errors-as-data. Clean Code prioritizes readability with small functions, exceptions, and intention-revealing names. They disagree on load-bearing points, so a repo adopts one; Tiger Style is the default when no preference is given.

Which programming languages does the guidelines generator support?

TypeScript, JavaScript, Rust, and Python each have a style-neutral base template plus Tiger Style and Clean Code overlays. For other languages, the Skill writes the section by analogy from the chosen style's core principles and notes the missing template in Open questions.

Does it support both git and jujutsu version control?

Yes. It detects .jj/ for jujutsu and .git/ for git, preferring jujutsu when both exist since jj is the working front end on a Git backend. Git guidelines can optionally be included alongside jj if the team wants them documented.

When should I create a per-package guidelines page instead of a global one?

Create a per-package page only when an app has genuine deltas from the global rules, such as an extra language or a stricter limit. It opens with a Read first pointer to the global page and documents only the deltas, never restating global rules.