リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

MITAuto-check passedProduct & Project Management

Install Repository Structure

skills CLI
$ npx skills add GenerativeAgents/claude-code-book-chapter8 --skill repository-structure -a claude-code

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

GitHub CLI
$ gh skill install GenerativeAgents/claude-code-book-chapter8 repository-structure --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/GenerativeAgents/claude-code-book-chapter8.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/repository-structure .claude/skills/repository-structure && 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
repository-structure
GitHub stars
119
Token cost
~237 tokens
SKILL.md length
42 words
Files
3
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

  • Works in 3 steps: docs/product-requirements.md (PRD) → docs/functional-design.md (機能設計書) → docs/architecture.md (アーキテクチャ設計書)
  • Product & Project Management work in your project
  • SKILL.md covers 前提条件, 既存ドキュメントの優先順位, 出力先 and テンプレートの参照, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Repository Structure is an agent skill from GenerativeAgents/claude-code-book-chapter8. リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用。

Its SKILL.md is about 240 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `guide.md` and `template.md`).

It sits in Product & Project Management. The licence is MIT.

When your agent uses it

  • Product & Project Management work in your project

Example prompts

  • “/repository-structure”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. docs/product-requirements.md (PRD)
  2. docs/functional-design.md (機能設計書)
  3. docs/architecture.md (アーキテクチャ設計書)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Repository Structure loads about 237 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 42 words of instructions outside code blocks.

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

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 GenerativeAgents/claude-code-book-chapter8 at commit 27c4191, republished under its MIT licence (© GenerativeAgents). 42 words, ~237 tokens.

Download SKILL.mdSave it as .claude/skills/repository-structure/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
repository-structure
description
リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用。
allowed-tools
Read, Write

リポジトリ構造定義スキル

このスキルは、明確で保守しやすいリポジトリ構造を定義するための詳細ガイドです。

前提条件

リポジトリ構造定義を開始する前に、以下を確認してください:

必須ドキュメント
  1. docs/product-requirements.md (PRD)
  2. docs/functional-design.md (機能設計書)
  3. docs/architecture.md (アーキテクチャ設計書)

リポジトリ構造は、アーキテクチャ設計で決定された技術スタックとシステム構成を反映した具体的なディレクトリ構造を定義します。

既存ドキュメントの優先順位

重要: docs/repository-structure.md に既存のリポジトリ構造定義書がある場合、以下の優先順位に従ってください:

  1. 既存のリポジトリ構造定義書 (docs/repository-structure.md) - 最優先

    • プロジェクト固有のディレクトリ構造が記載されている
    • このスキルのガイドより優先する
  2. このスキルのガイド - 参考資料

    • 汎用的なテンプレートと例
    • 既存定義書がない場合、または補足として使用

新規作成時: このスキルのテンプレートとガイドを参照 更新時: 既存定義書の構造と内容を維持しながら更新

出力先

作成したリポジトリ構造定義書は以下に保存してください:

docs/repository-structure.md

テンプレートの参照

リポジトリ構造定義書を作成する際は、次のテンプレートを使用してください: ./template.md

詳細ガイド

さらに詳しい作成ガイドは次のファイルを参照してください: ./guide.md

© GenerativeAgents, 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 2 other files in .claude/skills/repository-structure of GenerativeAgents/claude-code-book-chapter8.

  • SKILL.md
  • guide.md
  • template.md

Open the folder on GitHubat commit 27c4191

Compare with similar skills

Repository Structure 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.

Repository Structure compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repository Structure this skillGenerativeAgents/claude-code-book-chapter8119—~237Automated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Game Changing FeaturesopenstatusHQ/data-table-filters2.3k3 repos~2.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Convex Create Componentspokvulcan/poker-planning1148 repos~2.6kAutomated safety check: PassMIT
Self Improving Agentfarm-fe/farm5.6k2 repos~3.3kAutomated safety check: NotesMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Game Changing Features

    openstatusHQ/data-table-filters

    Find 10x product opportunities and high-leverage improvements.

    2.3k GitHub starsUsed in 3 repos~2.1k tokens
    Product & Project ManagementAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Convex Create Component

    spokvulcan/poker-planning

    Builds reusable Convex components with isolated tables and app-facing APIs.

    114 GitHub starsUsed in 8 repos~2.6k tokens
    Product & Project ManagementAuto-check passed
  • A universal self-improving agent that learns from ALL skill experiences.

    5.6k GitHub starsUsed in 2 repos~3.3k tokens
    Product & Project ManagementAuto-check: notes
  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed

More from GenerativeAgents/claude-code-book-chapter8

  • Development Guidelines

    GenerativeAgents/claude-code-book-chapter8

    チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。

    119 GitHub stars~521 tokensUpdated 7 mo ago
    Auto-check passed
  • Prd Writing

    GenerativeAgents/claude-code-book-chapter8

    プロダクト要求定義書(PRD)を作成するための詳細ガイドとテンプレート。PRD作成時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check passed
  • Steering

    GenerativeAgents/claude-code-book-chapter8

    作業指示毎の作業計画、タスクリストをドキュメントに記録するためのスキル。ユーザーからの指示をトリガーとした作業計画時、実装時、検証時に読み込む。

    119 GitHub stars~1.7k tokensUpdated 7 mo ago
    Auto-check passed
  • Architecture Design

    GenerativeAgents/claude-code-book-chapter8

    アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~217 tokensUpdated 7 mo ago
    Auto-check passed
  • Functional Design

    GenerativeAgents/claude-code-book-chapter8

    機能設計書を作成するための詳細ガイドとテンプレート。機能設計書作成時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~214 tokensUpdated 7 mo ago
    Auto-check passed
  • Glossary Creation

    GenerativeAgents/claude-code-book-chapter8

    用語集を作成するための詳細ガイドとテンプレート。用語集作成時にのみ使用。

    119 GitHub stars~241 tokensUpdated 7 mo ago
    Auto-check passed

Questions about Repository Structure

What does Repository Structure do?

リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8. Repository Structure is an agent skill from GenerativeAgents/claude-code-book-chapter8.

When should I use Repository Structure?

Repository Structure fits situations like: product & Project Management work in your project.

How do I install Repository Structure in Claude Code?

Run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill repository-structure -a claude-code`. Or copy the skill folder (.claude/skills/repository-structure in GenerativeAgents/claude-code-book-chapter8) into .claude/skills/repository-structure in your project. Claude Code loads it when a task matches its description.

How do I install Repository Structure in Codex?

Run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill repository-structure -a codex`. Or copy the skill folder (.claude/skills/repository-structure in GenerativeAgents/claude-code-book-chapter8) into .agents/skills/repository-structure in your project. Codex loads it when a task matches its description.

Can I use Repository Structure 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 GenerativeAgents/claude-code-book-chapter8 --skill repository-structure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repository-structure, .gemini/skills/repository-structure, .github/skills/repository-structure and .opencode/skills/repository-structure in your project.

What does Repository Structure need to run?

SKILL.md names no scripts, command-line tools or credentials: Repository Structure is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write.

Does Repository Structure 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 Repository Structure 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 Repository Structure use?

Repository Structure 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 Repository Structure use?

About 237 tokens (SKILL.md is roughly 948 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 Repository Structure?

Skills that share tags, products or a category with Repository Structure: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Game Changing Features (openstatusHQ/data-table-filters, 2.3k stars), CCPM Project Management (automazeio/ccpm, 8.4k stars) and Convex Create Component (spokvulcan/poker-planning, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repository Structure?

GenerativeAgents (a GitHub organization) maintains it in GenerativeAgents/claude-code-book-chapter8, which has 119 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on February 28, 2026.

Source: GenerativeAgents/claude-code-book-chapter8 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.