# michaelshimeles/skills architecture

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

- Interactive diagram: https://gitdiagram.com/michaelshimeles/skills
- Repository: https://github.com/michaelshimeles/skills

## Overview

This repository packages seven on-demand Claude Code skills rather than one application. The documented workflow starts with an isolated worktree, applies service-layer guidance during implementation, gathers evidence, then prepares visual proof and iterates Greptile review; prose cleanup applies throughout. Evidence-driven testing also includes a Python recorder. Other skill internals are represented only at the documented capability level because their source instructions were not sampled.

Main entry points: [`evidence-driven-testing/SKILL.md`](https://github.com/michaelshimeles/skills/blob/main/evidence-driven-testing/SKILL.md) (Test Evidence), [`before-and-after/SKILL.md`](https://github.com/michaelshimeles/skills/blob/main/before-and-after/SKILL.md) (Visual Comparison), [`new-feature/SKILL.md`](https://github.com/michaelshimeles/skills/blob/main/new-feature/SKILL.md) (Isolate Work), [`code-structure/SKILL.md`](https://github.com/michaelshimeles/skills/blob/main/code-structure/SKILL.md) (Structure Code)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow Guidance"]
  node_new_feature["Isolate Work<br/>[SKILL.md]"]
  node_code_structure["Structure Code<br/>[SKILL.md]"]
end

subgraph group_proof["Evidence and Visual Proof"]
  node_evidence_skill["Test Evidence<br/>[SKILL.md]"]
  node_recorder["Evidence Recorder<br/>[evidence.py]"]
  node_before_after["Visual Comparison<br/>[SKILL.md]"]
end

subgraph group_review["Review and Writing"]
  node_greploop["Greptile Review<br/>[SKILL.md]"]
  node_greploop_apps["Large-PR Review<br/>[SKILL.md]"]
  node_unslop["Polish Prose<br/>[SKILL.md]"]
end

node_developer(("Developer"))
node_app["Changed App"]
node_pr_tracker["PR and Tracker"]
node_greptile["Greptile"]

node_developer -->|"starts with"| node_new_feature
node_new_feature -->|"then builds"| node_code_structure
node_code_structure -->|"then proves"| node_evidence_skill
node_evidence_skill -->|"uses recorder"| node_recorder
node_evidence_skill -->|"tests live"| node_app
node_evidence_skill -->|"posts evidence"| node_pr_tracker
node_evidence_skill -->|"then ships"| node_before_after
node_before_after -->|"shares comparison"| node_pr_tracker
node_before_after -->|"then reviews"| node_greploop
node_greploop -->|"triggers review"| node_greptile
node_greploop_apps -->|"tags app"| node_greptile
node_developer -->|"polishes writing"| node_unslop

click node_new_feature "https://github.com/michaelshimeles/skills/blob/main/new-feature/SKILL.md"
click node_code_structure "https://github.com/michaelshimeles/skills/blob/main/code-structure/SKILL.md"
click node_evidence_skill "https://github.com/michaelshimeles/skills/blob/main/evidence-driven-testing/SKILL.md"
click node_recorder "https://github.com/michaelshimeles/skills/blob/main/evidence-driven-testing/scripts/evidence.py"
click node_before_after "https://github.com/michaelshimeles/skills/blob/main/before-and-after/SKILL.md"
click node_greploop "https://github.com/michaelshimeles/skills/blob/main/greploop/SKILL.md"
click node_greploop_apps "https://github.com/michaelshimeles/skills/blob/main/greploop-apps/SKILL.md"
click node_unslop "https://github.com/michaelshimeles/skills/blob/main/unslop/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_new_feature,node_code_structure toneBlue
class node_evidence_skill,node_recorder,node_before_after toneAmber
class node_greploop,node_greploop_apps,node_unslop toneMint
class node_developer,node_app,node_pr_tracker,node_greptile toneIndigo
```

## Components

### Workflow Guidance

- [Isolate Work](https://github.com/michaelshimeles/skills/blob/main/new-feature/SKILL.md): `new-feature/SKILL.md`
- [Structure Code](https://github.com/michaelshimeles/skills/blob/main/code-structure/SKILL.md): `code-structure/SKILL.md`

### Evidence and Visual Proof

- [Test Evidence](https://github.com/michaelshimeles/skills/blob/main/evidence-driven-testing/SKILL.md): `evidence-driven-testing/SKILL.md`
- [Evidence Recorder](https://github.com/michaelshimeles/skills/blob/main/evidence-driven-testing/scripts/evidence.py): `evidence-driven-testing/scripts/evidence.py`
- [Visual Comparison](https://github.com/michaelshimeles/skills/blob/main/before-and-after/SKILL.md): `before-and-after/SKILL.md`

### Review and Writing

- [Greptile Review](https://github.com/michaelshimeles/skills/blob/main/greploop/SKILL.md): `greploop/SKILL.md`
- [Large-PR Review](https://github.com/michaelshimeles/skills/blob/main/greploop-apps/SKILL.md): `greploop-apps/SKILL.md`
- [Polish Prose](https://github.com/michaelshimeles/skills/blob/main/unslop/SKILL.md): `unslop/SKILL.md`

### Other components

- **Developer**
- **Changed App**
- **PR and Tracker**
- **Greptile**

## Connections

- Developer → Isolate Work: starts with (evidence: `README.md`)
- Isolate Work → Structure Code: then builds (evidence: `README.md`)
- Structure Code → Test Evidence: then proves (evidence: `README.md`)
- Test Evidence → Evidence Recorder: uses recorder (evidence: `README.md`)
- Test Evidence → Changed App: tests live (evidence: `README.md`)
- Test Evidence → PR and Tracker: posts evidence (evidence: `README.md`)
- Test Evidence → Visual Comparison: then ships (evidence: `README.md`)
- Visual Comparison → PR and Tracker: shares comparison (evidence: `README.md`)
- Visual Comparison → Greptile Review: then reviews (evidence: `README.md`)
- Greptile Review → Greptile: triggers review (evidence: `README.md`)
- Large-PR Review → Greptile: tags app (evidence: `README.md`)
- Developer → Polish Prose: polishes writing (evidence: `README.md`)
