# popopo-99/build-your-own-skill architecture

> Architecture diagram of the GitHub repository popopo-99/build-your-own-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/popopo-99/build-your-own-skill
- Repository: https://github.com/popopo-99/build-your-own-skill

## Overview

Build Your Own Skill is an instruction-driven product for turning a person’s experience, prompts, SOPs, or existing Skill into a reusable AI capability. Its principal workflow moves from discovery and scoping through design, architecture, building, and iterative testing or repair, with file creation gated on the user’s request. The README describes SKILL.md as the orchestration layer and references as detailed methods; it also documents templates, examples, and teaching case studies. No source excerpts were provided, so relationships below rely on README statements only.

Main entry points: [`SKILL.md`](https://github.com/popopo-99/build-your-own-skill/blob/main/SKILL.md) (Skill Orchestrator), [`templates/SKILL_CANVAS.md`](https://github.com/popopo-99/build-your-own-skill/blob/main/templates/SKILL_CANVAS.md) (Skill Canvas), [`references/architecture.md`](https://github.com/popopo-99/build-your-own-skill/blob/main/references/architecture.md) (Skill Architecture), [`references/debugging.md`](https://github.com/popopo-99/build-your-own-skill/blob/main/references/debugging.md) (Diagnosis and Repair)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_orchestrator["Skill Orchestrator<br/>[SKILL.md]"]
  node_builder["Skill Build<br/>[SKILL.md]"]
end

subgraph group_design["Skill Design"]
  node_discovery["Discovery<br/>[discovery.md]"]
  node_deep_discovery["Deep Discovery<br/>[deep-discovery.md]"]
  node_scope["Skill Scope<br/>[skill-design.md]"]
  node_canvas["Skill Canvas<br/>[SKILL_CANVAS.md]"]
  node_workflow["Workflow Design<br/>[workflow-design.md]"]
  node_knowledge["Knowledge Design"]
  node_architecture["Skill Architecture<br/>[architecture.md]"]
end

subgraph group_validation["Validation"]
  node_behavior_testing["Behavior Testing<br/>[testing.md]"]
  node_evaluation["Comparative Evaluation<br/>[evaluation.md]"]
  node_debugging["Diagnosis and Repair<br/>[debugging.md]"]
end

subgraph group_resources["Learning Resources"]
  node_basic_template["Basic Skill Template<br/>[BASIC_SKILL.md]"]
  node_case_studies["Case Studies"]
  node_example_skill["Example Skill<br/>[SKILL.md]"]
end

node_user(("Skill Creator"))
node_source_material["Experience or Prompt"]
node_created_skill["Created Skill"]

node_user -->|"provides input"| node_source_material
node_source_material -->|"guides"| node_orchestrator
node_user -->|"requests creation"| node_orchestrator
node_orchestrator -->|"selects guidance"| node_discovery
node_orchestrator -->|"selects when needed"| node_deep_discovery
node_discovery -->|"narrows to"| node_scope
node_scope -->|"organizes design"| node_canvas
node_canvas -->|"informs"| node_workflow
node_canvas -->|"informs"| node_knowledge
node_workflow -->|"informs"| node_architecture
node_knowledge -->|"informs"| node_architecture
node_architecture -->|"guides"| node_builder
node_builder -->|"generates"| node_created_skill
node_created_skill -->|"validates behavior"| node_behavior_testing
node_created_skill -->|"compares results"| node_evaluation
node_behavior_testing -->|"informs repair"| node_debugging
node_evaluation -->|"informs repair"| node_debugging
node_debugging -->|"guides revision"| node_builder
node_user -->|"may start from"| node_basic_template
node_user -->|"may learn from"| node_case_studies
node_user -->|"may inspect"| node_example_skill

click node_orchestrator "https://github.com/popopo-99/build-your-own-skill/blob/main/SKILL.md"
click node_discovery "https://github.com/popopo-99/build-your-own-skill/blob/main/references/discovery.md"
click node_deep_discovery "https://github.com/popopo-99/build-your-own-skill/blob/main/references/deep-discovery.md"
click node_scope "https://github.com/popopo-99/build-your-own-skill/blob/main/references/skill-design.md"
click node_canvas "https://github.com/popopo-99/build-your-own-skill/blob/main/templates/SKILL_CANVAS.md"
click node_workflow "https://github.com/popopo-99/build-your-own-skill/blob/main/references/workflow-design.md"
click node_knowledge "https://github.com/popopo-99/build-your-own-skill/blob/main/references/knowledge-design.md"
click node_architecture "https://github.com/popopo-99/build-your-own-skill/blob/main/references/architecture.md"
click node_basic_template "https://github.com/popopo-99/build-your-own-skill/blob/main/templates/BASIC_SKILL.md"
click node_builder "https://github.com/popopo-99/build-your-own-skill/blob/main/SKILL.md"
click node_behavior_testing "https://github.com/popopo-99/build-your-own-skill/blob/main/references/testing.md"
click node_evaluation "https://github.com/popopo-99/build-your-own-skill/blob/main/references/evaluation.md"
click node_debugging "https://github.com/popopo-99/build-your-own-skill/blob/main/references/debugging.md"
click node_case_studies "https://github.com/popopo-99/build-your-own-skill/tree/main/case-studies"
click node_example_skill "https://github.com/popopo-99/build-your-own-skill/blob/main/examples/brand-visual-director/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_orchestrator,node_builder toneBlue
class node_discovery,node_deep_discovery,node_scope,node_canvas,node_workflow,node_knowledge,node_architecture toneAmber
class node_behavior_testing,node_evaluation,node_debugging toneMint
class node_basic_template,node_case_studies,node_example_skill toneRose
class node_user,node_source_material,node_created_skill toneIndigo
```

## Components

### Orchestration

- [Skill Orchestrator](https://github.com/popopo-99/build-your-own-skill/blob/main/SKILL.md): `SKILL.md`
- [Skill Build](https://github.com/popopo-99/build-your-own-skill/blob/main/SKILL.md): `SKILL.md`

### Skill Design

- [Discovery](https://github.com/popopo-99/build-your-own-skill/blob/main/references/discovery.md): `references/discovery.md`
- [Deep Discovery](https://github.com/popopo-99/build-your-own-skill/blob/main/references/deep-discovery.md): `references/deep-discovery.md`
- [Skill Scope](https://github.com/popopo-99/build-your-own-skill/blob/main/references/skill-design.md): `references/skill-design.md`
- [Skill Canvas](https://github.com/popopo-99/build-your-own-skill/blob/main/templates/SKILL_CANVAS.md): `templates/SKILL_CANVAS.md`
- [Workflow Design](https://github.com/popopo-99/build-your-own-skill/blob/main/references/workflow-design.md): `references/workflow-design.md`
- [Knowledge Design](https://github.com/popopo-99/build-your-own-skill/blob/main/references/knowledge-design.md): `references/knowledge-design.md`
- [Skill Architecture](https://github.com/popopo-99/build-your-own-skill/blob/main/references/architecture.md): `references/architecture.md`

### Validation

- [Behavior Testing](https://github.com/popopo-99/build-your-own-skill/blob/main/references/testing.md): `references/testing.md`
- [Comparative Evaluation](https://github.com/popopo-99/build-your-own-skill/blob/main/references/evaluation.md): `references/evaluation.md`
- [Diagnosis and Repair](https://github.com/popopo-99/build-your-own-skill/blob/main/references/debugging.md): `references/debugging.md`

### Learning Resources

- [Basic Skill Template](https://github.com/popopo-99/build-your-own-skill/blob/main/templates/BASIC_SKILL.md): `templates/BASIC_SKILL.md`
- [Case Studies](https://github.com/popopo-99/build-your-own-skill/tree/main/case-studies): `case-studies`
- [Example Skill](https://github.com/popopo-99/build-your-own-skill/blob/main/examples/brand-visual-director/SKILL.md): `examples/brand-visual-director/SKILL.md`

### Other components

- **Skill Creator**
- **Experience or Prompt**
- **Created Skill**

## Connections

- Skill Creator → Experience or Prompt: provides input (evidence: `README.md`)
- Experience or Prompt → Skill Orchestrator: guides (evidence: `README.md`)
- Skill Creator → Skill Orchestrator: requests creation (evidence: `README.md`)
- Skill Orchestrator → Discovery: selects guidance (evidence: `README.md`)
- Skill Orchestrator → Deep Discovery: selects when needed (evidence: `README.md`)
- Discovery → Skill Scope: narrows to (evidence: `README.md`)
- Skill Scope → Skill Canvas: organizes design (evidence: `README.md`)
- Skill Canvas → Workflow Design: informs (evidence: `README.md`)
- Skill Canvas → Knowledge Design: informs (evidence: `README.md`)
- Workflow Design → Skill Architecture: informs (evidence: `README.md`)
- Knowledge Design → Skill Architecture: informs (evidence: `README.md`)
- Skill Architecture → Skill Build: guides (evidence: `README.md`)
- Skill Build → Created Skill: generates (evidence: `README.md`)
- Created Skill → Behavior Testing: validates behavior (evidence: `README.md`)
- Created Skill → Comparative Evaluation: compares results (evidence: `README.md`)
- Behavior Testing → Diagnosis and Repair: informs repair (evidence: `README.md`)
- Comparative Evaluation → Diagnosis and Repair: informs repair (evidence: `README.md`)
- Diagnosis and Repair → Skill Build: guides revision (evidence: `README.md`)
- Skill Creator → Basic Skill Template: may start from (evidence: `README.md`)
- Skill Creator → Case Studies: may learn from (evidence: `README.md`)
- Skill Creator → Example Skill: may inspect (evidence: `README.md`)