skills.rest
rmans
rmansCOMMUNITY
Explore all skills by this author →
GitHub

scaffold-new-spec

Create atomic behavior specifications from system designs and ADRs.

Updated Aug 23, 2026
Search Tags:#testing#game development#specification#ADR#design documents#behavior design
One-click install
npx skills add https://github.com/rmans/ClaudeScaffold --skill scaffold-new-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scaffold-new-spec
Source: https://github.com/rmans/ClaudeScaffold/tree/main/Install/.claude/skills/scaffold-new-spec
Command: npx skills add https://github.com/rmans/ClaudeScaffold --skill scaffold-new-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of detailed, testable behavior specifications for game development, ensuring consistency and adherence to design documents.

Core Features & Use Cases

  • Atomic Spec Creation: Generates individual behavior specs based on system designs and ADRs.
  • Contextual Awareness: Reads relevant design documents, ADRs, and playtest feedback to inform spec content.
  • Guided Workflow: Walks the user through defining preconditions, behavior, postconditions, edge cases, and acceptance criteria.
  • Use Case: When designing a new game mechanic, use this Skill to create a precise specification for how a player action should behave, ensuring all edge cases and requirements are captured.

Quick Start

Use the scaffold-new-spec skill to create a new behavior spec named 'player-jump-mechanic'.

Frequently Asked Questions about scaffold-new-spec

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

FAQPage Schema
How do I create testable behavior specifications for game mechanics?▼

Testable behavior specifications for game mechanics are created by defining atomic behaviors, preconditions, postconditions, edge cases, and acceptance criteria. This ensures game mechanics are scoped precisely and captured for structured design documentation.

How do I generate game development specs that adhere to architectural decisions?▼

Game development specs adhere to architectural decisions by reading system designs and ADRs to inform spec content. This contextual awareness ensures generated behavior specifications align with established architectural constraints and requirements.

What is the best way to scope edge cases and acceptance criteria for a new game mechanic?▼

Scoping edge cases and acceptance criteria for a new game mechanic is best done through a guided workflow that walks you through defining individual behavior specs. This captures specific requirements and edge cases for player actions.

Can I use playtest feedback to inform behavior spec creation?▼

Playtest feedback can be used to inform behavior spec creation by reading it alongside design documents and ADRs. This contextual awareness ensures generated specifications reflect actual player interactions and system behaviors.

When do I need atomic behavior specs for game development slices?▼

Atomic behavior specs for game development slices are needed when designing new game mechanics to ensure consistency and adherence to design documents. They define testable behaviors and acceptance criteria for specific player actions.

Related Skills

Explore More Software Engineering Skills→
mayurpisemayurpise
39

validate

Validate codebase quality against Draft context documents and workflow.md settings.

Community
Advanced
prof-danielcprof-danielc

speckit.validate

Validate code implementations against specification requirements and acceptance criteria.

Community
Intermediate
afoveaafovea

game-design-framework

Evaluate game mechanics with the 5-Component Relevance Filter and state machine documentation.

Community
Advanced
sumilee-pcusumilee-pcu

create-architecture

Generate master architecture documents from game design documents and technical requirements.

Community
Advanced