Agent skill

Repo Scaffold

by majiayu000 in majiayu000/spellbook

Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs.

MITAuto-check passedDevelopment

Install Repo Scaffold

skills CLI
$ npx skills add majiayu000/spellbook --skill repo-scaffold -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install majiayu000/spellbook repo-scaffold --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/majiayu000/spellbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/repo-scaffold .claude/skills/repo-scaffold && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
repo-scaffold
GitHub stars
287
Token cost
~651 tokens
SKILL.md length
235 words
Files
2
Skills in repo
97
Repo updated
First seen
Licence
MIT

At a glance

Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs.

  • Starting a new repo
  • SKILL.md covers Purpose, Search First, Scaffold Layers and Decision Rules, plus 1 more section
  • Calls rg
  • Turning a prototype into a maintainable project

What it does

Repo Scaffold is an agent skill from majiayu000/spellbook. Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs. Use when starting a new repo, turning a prototype into a maintainable project, adding missing repository foundations, or creating a repo skeleton before implementation. For AGENTS.md-only context scaffolding, use agentsmd-scaffold.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Project scaffolding, Codebase knowledge for agents and Changelog and release notes. The repository describes itself as: Cross-runtime skills for Claude Code, Codex, and multi-agent workflows. The licence is MIT.

When your agent uses it

  • Starting a new repo
  • Turning a prototype into a maintainable project
  • Adding missing repository foundations
  • Creating a repo skeleton before implementation

Example prompts

  • “/repo-scaffold”

What it can do on your machine

Read from SKILL.md and the folder at commit ed52af7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Repo Scaffold loads about 651 tokens when it runs. Until then it costs about 104 tokens; SKILL.md has 235 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~651

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/spellbook at commit ed52af7, republished under its MIT licence (© majiayu000). 235 words, ~651 tokens.

Download SKILL.mdSave it as .claude/skills/repo-scaffold/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
repo-scaffold
description
Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs. Use when starting a new repo, turning a prototype into a maintainable project, adding missing repository foundations, or creating a repo skeleton before implementation. For AGENTS.md-only context scaffolding, use agentsmd-scaffold.

Repo Scaffold

Purpose

Use this skill to create the repo foundation that lets product, architecture, implementation, verification, and operations stay connected. It is broader than agentsmd-scaffold; it may include AGENTS.md, but also specs, tests, CI, config, release, and runbook structure.

Search First

Before adding files, inspect the repo for existing equivalents:

bash
rg --files -g 'AGENTS.md' -g 'CONTRIBUTING.md' -g 'README*' -g 'pyproject.toml' -g 'package.json' -g 'go.mod' -g 'Cargo.toml' -g '.github/workflows/*' -g 'docs/**' -g 'specs/**' -g 'tests/**'

Reuse existing conventions. Do not create parallel docs/, spec/, planning/, or test/ trees when the repo already has a standard location.

Scaffold Layers

Add only the layers needed for the repo:

LayerTypical Files
Product and specsspecs/PRODUCT.md, specs/TECH.md, docs/adr/
Agent contextAGENTS.md, scoped AGENTS.md, local skill notes
Source layoutlanguage-specific src/, pkg/, cmd/, app/, lib/
Teststests/, fixtures, golden snapshots, e2e harness
CI.github/workflows/ci.yml, lint/typecheck/test jobs
Config.env.example, config schema, secret inventory
ReleaseCHANGELOG.md, release checklist, versioning notes
Operationsdocs/runbooks/, SLO and incident templates

Decision Rules

  • For a new repo, propose the tree first, then create files only after the user asks to apply.
  • For an existing repo, make the smallest additive change that closes the foundation gap.
  • Keep generated starter files short and executable. Prefer empty placeholders only when a tool requires them.
  • Do not hardcode credentials, service names, ports, or cloud providers without repo evidence.
  • Do not overwrite existing README, CI, or config files without showing the diff intent.

Minimal Output

For planning:

text
existing_foundation:
missing_layers:
proposed_tree:
files_to_create_or_update:
verification_commands:

For implementation, finish by running the repo's validation command and, when available, the scaffold-specific lint or generated-file check.

© majiayu000, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/repo-scaffold of majiayu000/spellbook.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit ed52af7

Compare with similar skills

Repo Scaffold next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Repo Scaffold compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Scaffold this skillmajiayu000/spellbook287—~651Automated safety check: PassMIT
ReleaseYesterday-AI/paperclip-plugin-company-wizard186—~1.6kAutomated safety check: PassMIT
Documentdcodesdev/LetterSpace100—~461Automated safety check: PassMIT
Dx Harnesspproenca/dot-skills215—~1.5kAutomated safety check: PassMIT
MCP Server Trello Releasedelorenj/mcp-server-trello445—~3.5kAutomated safety check: PassMIT
Abo Docsjeeftor/audiobook-organizer190—~499Automated safety check: PassMIT

Similar skills

  • Release

    Yesterday-AI/paperclip-plugin-company-wizard

    Prepare a new release by updating CHANGELOG.md, verifying documentation (README.md, CLAUDE.md, AGENTS.md, ROADMAP.md, docs/), bumping patch version in package.json, building, and suggesting publish…

    186 GitHub stars~1.6k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Document

    dcodesdev/LetterSpace

    Use this when writing or updating documentation — a README, docs/ page, CLAUDE.md, changelog entry, or doc comments — or when the user says 'document this'.

    100 GitHub stars~461 tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    215 GitHub stars~1.5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • MCP Server Trello Release

    delorenj/mcp-server-trello

    Canonical build → release → tag → publish procedure for the @delorenj/mcp-server-trello repo.

    445 GitHub stars~3.5k tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • Abo Docs

    jeeftor/audiobook-organizer

    Update Audiobook Organizer documentation, AGENTS.md, changelog entries, and maintainer-facing workflow notes while keeping repo-local skill references consistent.

    190 GitHub stars~499 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Agents Generator

    sickn33/agentic-awesome-skills

    Generate project-specific AGENTS.md and companion rules by analyzing a codebase.

    47k GitHub starsUsed in 1 repo~2.3k tokens
    DevelopmentAuto-check: notes

More from majiayu000/spellbook

All 97 skills in this repo
  • Skill Ecosystem Doctor

    majiayu000/spellbook

    Audits and repairs how coding-agent Skills are owned, copied and exposed across runtimes, from canonical sources to quarantine and retirement.

    287 GitHub stars~3k tokensUpdated 3 days ago
    Auto-check passed
  • AGENTS.md Scaffold

    majiayu000/spellbook

    Scans a repository for real evidence and proposes, or on request writes, a small stack of root and scoped AGENTS.md files with validation commands and generated-file boundaries.

    287 GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Product Demo Builder

    majiayu000/spellbook

    Plans, produces or diagnoses evidence-backed product demo videos: script, capture plan, pacing checks and verified final media built on real product behavior.

    287 GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed
  • Flowguard Task Guard

    majiayu000/spellbook

    Single entry point that routes long or ambiguous agent tasks, checks live state, bounds autonomous loops and leaves a resumable handoff.

    287 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • npm Supply Chain Check

    majiayu000/spellbook

    Scans a repository, its lockfiles and node_modules for known malicious npm package versions and install-time indicators, using a read-only Python scanner.

    287 GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Product Manager Toolkit

    majiayu000/spellbook

    Product management helpers: a RICE scoring script, an interview transcript analyzer and PRD templates for prioritizing features, synthesizing research and writing requirements.

    287 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

Questions about Repo Scaffold

What does Repo Scaffold do?

Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs. Repo Scaffold is an agent skill from majiayu000/spellbook. Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs.

When should I use Repo Scaffold?

Repo Scaffold fits situations like: starting a new repo; turning a prototype into a maintainable project; adding missing repository foundations; creating a repo skeleton before implementation.

How do I install Repo Scaffold in Claude Code?

Run `npx skills add majiayu000/spellbook --skill repo-scaffold -a claude-code`. Or copy the skill folder (skills/repo-scaffold in majiayu000/spellbook) into .claude/skills/repo-scaffold in your project. Claude Code loads it when a task matches its description.

How do I install Repo Scaffold in Codex?

Run `npx skills add majiayu000/spellbook --skill repo-scaffold -a codex`. Or copy the skill folder (skills/repo-scaffold in majiayu000/spellbook) into .agents/skills/repo-scaffold in your project. Codex loads it when a task matches its description.

Can I use Repo Scaffold in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add majiayu000/spellbook --skill repo-scaffold -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repo-scaffold, .gemini/skills/repo-scaffold, .github/skills/repo-scaffold and .opencode/skills/repo-scaffold in your project.

What does Repo Scaffold need to run?

Going by SKILL.md and its folder, Repo Scaffold needs the command-line tools its instructions call (rg).

Does Repo Scaffold access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Repo Scaffold safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Repo Scaffold use?

Repo Scaffold is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Repo Scaffold use?

About 651 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Repo Scaffold?

Skills that share tags, products or a category with Repo Scaffold: Release (Yesterday-AI/paperclip-plugin-company-wizard, 186 stars), Document (dcodesdev/LetterSpace, 100 stars), Dx Harness (pproenca/dot-skills, 215 stars) and MCP Server Trello Release (delorenj/mcp-server-trello, 445 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Scaffold?

majiayu000 (a GitHub user) maintains it in majiayu000/spellbook, which has 287 GitHub stars. The repository holds 97 skills in this directory. The repository was last updated on October 8, 2026.

Source: majiayu000/spellbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.