# robonuggets/skills architecture

> Architecture diagram of the GitHub repository robonuggets/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/robonuggets/skills
- Repository: https://github.com/robonuggets/skills

## Overview

This repository is a collection of three Claude Code skills, not a conventional application. A user invokes a skill in-session: calibrate reviews the conversation and suggests targeted improvements; personalise adapts external material to the user’s context; tweak injects controls into a single-file HTML page so adjusted values can be baked back into its CSS. The README documents these capabilities and triggers, but no source excerpts were provided, so relationships shown here are limited to those documented there.

Main entry points: [`personalise/SKILL.md`](https://github.com/robonuggets/skills/blob/main/personalise/SKILL.md) (Personalise Skill), [`tweak/SKILL.md`](https://github.com/robonuggets/skills/blob/main/tweak/SKILL.md) (Tweak Skill), [`calibrate/SKILL.md`](https://github.com/robonuggets/skills/blob/main/calibrate/SKILL.md) (Calibrate Skill), [`tweak/panel.html`](https://github.com/robonuggets/skills/blob/main/tweak/panel.html) (Controls Panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_calibrate["Session Improvement"]
  node_calibrate_skill["Calibrate Skill<br/>[SKILL.md]"]
end

subgraph group_personalise["Input Adaptation"]
  node_personalise_skill["Personalise Skill<br/>[SKILL.md]"]
end

subgraph group_tweak["HTML Tuning"]
  node_tweak_skill["Tweak Skill<br/>[SKILL.md]"]
  node_controls_panel["Controls Panel<br/>[panel.html]"]
end

node_user(("User"))
node_conversation["Current Conversation"]
node_skill_updates["Skill Updates"]
node_external_input["External Input"]
node_workspace_context["Workspace Context"]
node_adaptation_recommendation["Adaptation Recommendation"]
node_html_source["Single-file HTML"]
node_baked_html["Adjusted HTML"]

node_user -->|"invokes"| node_calibrate_skill
node_calibrate_skill -->|"reviews"| node_conversation
node_calibrate_skill -->|"suggests"| node_skill_updates
node_user -->|"invokes"| node_personalise_skill
node_user -->|"provides"| node_external_input
node_personalise_skill -->|"adapts"| node_external_input
node_personalise_skill -->|"considers"| node_workspace_context
node_personalise_skill -->|"recommends"| node_adaptation_recommendation
node_user -->|"invokes"| node_tweak_skill
node_user -->|"provides"| node_html_source
node_tweak_skill -->|"injects"| node_controls_panel
node_tweak_skill -->|"scans"| node_html_source
node_tweak_skill -->|"bakes values"| node_baked_html

click node_calibrate_skill "https://github.com/robonuggets/skills/blob/main/calibrate/SKILL.md"
click node_personalise_skill "https://github.com/robonuggets/skills/blob/main/personalise/SKILL.md"
click node_tweak_skill "https://github.com/robonuggets/skills/blob/main/tweak/SKILL.md"
click node_controls_panel "https://github.com/robonuggets/skills/blob/main/tweak/panel.html"

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_calibrate_skill,node_user toneBlue
class node_personalise_skill toneAmber
class node_tweak_skill,node_controls_panel toneMint
class node_conversation,node_skill_updates,node_external_input,node_workspace_context,node_adaptation_recommendation,node_html_source,node_baked_html toneIndigo
```

## Components

### Session Improvement

- [Calibrate Skill](https://github.com/robonuggets/skills/blob/main/calibrate/SKILL.md): `calibrate/SKILL.md`

### Input Adaptation

- [Personalise Skill](https://github.com/robonuggets/skills/blob/main/personalise/SKILL.md): `personalise/SKILL.md`

### HTML Tuning

- [Tweak Skill](https://github.com/robonuggets/skills/blob/main/tweak/SKILL.md): `tweak/SKILL.md`
- [Controls Panel](https://github.com/robonuggets/skills/blob/main/tweak/panel.html): `tweak/panel.html`

### Other components

- **User**
- **Current Conversation**
- **Skill Updates**
- **External Input**
- **Workspace Context**
- **Adaptation Recommendation**
- **Single-file HTML**
- **Adjusted HTML**

## Connections

- User → Calibrate Skill: invokes (evidence: `README.md`)
- Calibrate Skill → Current Conversation: reviews (evidence: `README.md`)
- Calibrate Skill → Skill Updates: suggests (evidence: `README.md`)
- User → Personalise Skill: invokes (evidence: `README.md`)
- User → External Input: provides (evidence: `README.md`)
- Personalise Skill → External Input: adapts (evidence: `README.md`)
- Personalise Skill → Workspace Context: considers (evidence: `README.md`)
- Personalise Skill → Adaptation Recommendation: recommends (evidence: `README.md`)
- User → Tweak Skill: invokes (evidence: `README.md`)
- User → Single-file HTML: provides (evidence: `README.md`)
- Tweak Skill → Controls Panel: injects (evidence: `README.md`)
- Tweak Skill → Single-file HTML: scans (evidence: `README.md`)
- Tweak Skill → Adjusted HTML: bakes values (evidence: `README.md`)
