# rebelytics/one-skill-to-rule-them-all architecture

> Architecture diagram of the GitHub repository rebelytics/one-skill-to-rule-them-all, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rebelytics/one-skill-to-rule-them-all
- Repository: https://github.com/rebelytics/one-skill-to-rule-them-all

## Overview

Task Observer is an agent-guided meta-skill for spotting reusable work patterns and improving a skill library. The principal workflow is: observe a work session, record structured signals, produce a log or handoff, then let the user review recommendations before updating skills. Cross-cutting principles and new-skill candidates extend that loop. The graph is based on the README and repository tree; detailed runtime wiring is not visible in the sampled source, so the links represent documented workflow rather than inferred code calls.

Main entry points: [`SKILL.md`](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/SKILL.md) (Observer skill), [`references/weekly-review.md`](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/weekly-review.md) (Weekly review), [`references/environments.md`](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/environments.md) (Environment activation), [`scripts/migrate-log.py`](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/migrate-log.py) (Legacy log migration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_observe["Session observation"]
  node_skill["Observer skill<br/>[SKILL.md]"]
end

subgraph group_record["Signals and records"]
  node_signals["Observation signals<br/>[signals.md]"]
  node_logguide["Observation log guide<br/>[observation-log.md]"]
  node_logfiles[("Observation files")]
  node_handoff["Handoff document"]
end

subgraph group_improve["Review and improvement"]
  node_principles["Cross-cutting principles"]
  node_review["Weekly review<br/>[weekly-review.md]"]
  node_updates["Proposed skill updates"]
  node_authoring["Skill authoring<br/>[skill-authoring.md]"]
end

subgraph group_setup["Setup and maintenance"]
  node_environment["Environment activation<br/>[environments.md]"]
  node_migration["Legacy log migration<br/>[migrate-log.py]"]
  node_newobs["Observation helper<br/>[new-observation.sh]"]
  node_validation["Bundle validation"]
end

node_user(("Skill user"))
node_agent(("AI agent"))

node_user -->|"works with"| node_agent
node_agent -->|"uses"| node_skill
node_skill -->|"checks for"| node_signals
node_skill -->|"follows"| node_logguide
node_skill -->|"records"| node_logfiles
node_skill -->|"produces"| node_handoff
node_skill -->|"checks against"| node_principles
node_user -->|"reviews with"| node_review
node_review -->|"reviews"| node_logfiles
node_review -->|"approves recommendations"| node_updates
node_agent -->|"prepares"| node_updates
node_agent -->|"uses for candidates"| node_authoring
node_environment -->|"activates"| node_skill
node_newobs -->|"creates entries"| node_logfiles
node_migration -->|"converts legacy logs"| node_logfiles
node_validation -.->|"checks bundle"| node_updates

click node_skill "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/SKILL.md"
click node_signals "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/signals.md"
click node_logguide "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/observation-log.md"
click node_principles "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/starter-principles.md"
click node_review "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/weekly-review.md"
click node_authoring "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/skill-authoring.md"
click node_environment "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/environments.md"
click node_migration "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/migrate-log.py"
click node_newobs "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/new-observation.sh"
click node_validation "https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/validate-skill-bundle.py"

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_skill,node_user toneBlue
class node_signals,node_logguide,node_logfiles,node_handoff toneAmber
class node_principles,node_review,node_updates,node_authoring toneMint
class node_environment,node_migration,node_newobs,node_validation toneRose
class node_agent toneIndigo
```

## Components

### Session observation

- [Observer skill](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/SKILL.md): `SKILL.md`

### Signals and records

- [Observation signals](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/signals.md): `references/signals.md`
- [Observation log guide](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/observation-log.md): `references/observation-log.md`
- **Observation files**
- **Handoff document**

### Review and improvement

- [Cross-cutting principles](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/starter-principles.md): `references/starter-principles.md`
- [Weekly review](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/weekly-review.md): `references/weekly-review.md`
- **Proposed skill updates**
- [Skill authoring](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/skill-authoring.md): `references/skill-authoring.md`

### Setup and maintenance

- [Environment activation](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/environments.md): `references/environments.md`
- [Legacy log migration](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/migrate-log.py): `scripts/migrate-log.py`
- [Observation helper](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/new-observation.sh): `scripts/new-observation.sh`
- [Bundle validation](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/scripts/validate-skill-bundle.py): `scripts/validate-skill-bundle.py`

### Other components

- **Skill user**
- **AI agent**

## Connections

- Skill user → AI agent: works with
- AI agent → Observer skill: uses
- Observer skill → Observation signals: checks for
- Observer skill → Observation log guide: follows
- Observer skill → Observation files: records
- Observer skill → Handoff document: produces
- Observer skill → Cross-cutting principles: checks against
- Skill user → Weekly review: reviews with
- Weekly review → Observation files: reviews
- Weekly review → Proposed skill updates: approves recommendations
- AI agent → Proposed skill updates: prepares
- AI agent → Skill authoring: uses for candidates
- Environment activation → Observer skill: activates
- Observation helper → Observation files: creates entries
- Legacy log migration → Observation files: converts legacy logs
- Bundle validation → Proposed skill updates: checks bundle