Can I use this to set up a new repository?

Yes, by using the --root flag, the skill scaffolds the top-level documentation structure for the entire repository.

Is the module type required when scaffolding?

Yes, the type must be specified explicitly (core, lib, or app) to ensure the skill doesn't guess your project requirements incorrectly.

Does the skill automatically fill in my name and date?

Yes, it pulls your Git username and the current date to replace placeholders in the generated documentation templates.

What module types are supported by the scaffold skill?

The skill supports 'core', 'lib', and 'app' module types, each generating specific directories and files tailored to that module's purpose.

How do I ensure the scaffolded structure is correct?

The skill includes a built-in validation step that runs a shell script to verify the generated directory and file structure.

Principled Module Scaffolding

Name: Principled Module Scaffolding
Author: alexnodeland

byalexnodeland

•

Content Management

Automates the creation of standardized, specification-driven documentation structures for software modules and repository roots.

The Scaffold skill streamlines project initialization by generating consistent directory structures for architectural decisions, proposals, and plans. Designed for specification-driven development, it uses templates to create essential files like README.md, CLAUDE.md, and CONTRIBUTING.md, automatically populating them with metadata like module names and author info. Whether you are building a library, a core service, or a full application, this skill ensures your documentation environment is correctly configured and validated from the start.

Key Features

01Template-based file creation for core, library, and application module types

02Dynamic placeholder replacement for module names, dates, and author metadata

03Automated directory generation for proposals, plans, decisions, and architecture

043 GitHub stars

05Support for repo-wide root scaffolding and specific module pathing

06Integrated structural validation via shell scripts to ensure compliance

Use Cases

01Scaffolding application modules with required runbooks and integration guides

02Setting up a repository-wide documentation structure to track architectural decisions

03Initializing a new library module with standardized interface documentation and examples

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled scaffold

For use in Claude.ai and ChatGPT

Download Skill