# theeranon/jamesskills architecture

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

- Interactive diagram: https://gitdiagram.com/theeranon/jamesskills
- Repository: https://github.com/theeranon/jamesskills

## Overview

JamesSkills is a portable library of AI collaboration workflows, distributed as Claude Code plugins and made available to other AI hosts. The user-facing path is a person invoking a skill or command, then receiving guided reasoning, research, coaching, or a deliverable; some workflows consult registered knowledge lenses or offer interactive tools over MCP. The README documents three distinct pillars and further skills beyond sampled source. The graph preserves these documented capabilities, while edges are limited to relationships directly supported by excerpts or README statements; most prompt-driven skill handoffs are not source-verified.

Main entry points: [`plugins/james-software/skills/make-it-james-ux/SKILL.md`](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/SKILL.md) (Interface standards), [`plugins/james-productivity/skills`](https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/skills) (Productivity workflows), [`plugins/james-productivity/skills/baseon/SKILL.md`](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/baseon/SKILL.md) (Knowledge lens skill), [`plugins/james-productivity/skills/baseon/scripts/knowledge_library.py`](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/baseon/scripts/knowledge_library.py) (Lens library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pillars["Skill pillars"]
  node_core["Core workflows"]
  node_productivity["Productivity workflows"]
  node_software["Software workflows"]
  node_decision["Decision gates"]
  node_execution["Task execution<br/>[SKILL.md]"]
  node_quality["Output standard<br/>[SKILL.md]"]
  node_stress["Interactive stress-test<br/>[SKILL.md]"]
  node_options["Options research<br/>[SKILL.md]"]
  node_reframe["System reframing<br/>[SKILL.md]"]
  node_coaching["Coaching<br/>[SKILL.md]"]
  node_deliverables["Meeting and briefs"]
  node_engineering["Engineering method<br/>[SKILL.md]"]
  node_project["Project contract<br/>[SKILL.md]"]
  node_catchup["Project recovery<br/>[SKILL.md]"]
  node_ux["Interface standards<br/>[SKILL.md]"]
end

subgraph group_knowledge["Knowledge lenses"]
  node_knowledge_skill["Knowledge lens skill<br/>[SKILL.md]"]
  node_library["Lens library"]
  node_packs["Lens packs"]
end

subgraph group_interfaces["Host interfaces"]
  node_mcp["MCP tools<br/>[server.py]"]
end

subgraph group_internal["Workflow support"]
  node_grill_builder["Session builder<br/>[build_session.py]"]
  node_snapshot["Git snapshot"]
  node_standard_tool["Contract utility"]
  node_outcome_lint["Output lint<br/>[lint_outcome.py]"]
  node_ux_lint["UX lint<br/>[lint_outcome.py]"]
  node_font_embed["Font embedding"]
end

node_person(("AI collaborator"))

node_person -->|"invokes"| node_core
node_person -->|"invokes"| node_productivity
node_person -->|"invokes"| node_software
node_productivity -->|"applies lens"| node_knowledge_skill
node_knowledge_skill -.->|"queries library"| node_library
node_library -.->|"reads packs"| node_packs
node_person -->|"calls tools"| node_mcp
node_mcp -.->|"launches session"| node_grill_builder
node_stress -->|"builds session"| node_grill_builder
node_catchup -.->|"captures state"| node_snapshot
node_project -.->|"uses utility"| node_standard_tool
node_quality -.->|"checks output"| node_outcome_lint
node_ux -.->|"checks interface"| node_ux_lint
node_ux -.->|"embeds fonts"| node_font_embed

click node_core "https://github.com/theeranon/jamesskills/tree/main/plugins/james-core/skills"
click node_productivity "https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/skills"
click node_software "https://github.com/theeranon/jamesskills/tree/main/plugins/james-software/skills"
click node_decision "https://github.com/theeranon/jamesskills/tree/main/plugins/james-core/skills"
click node_execution "https://github.com/theeranon/jamesskills/blob/main/plugins/james-core/skills/done-for-me/SKILL.md"
click node_quality "https://github.com/theeranon/jamesskills/blob/main/plugins/james-core/skills/make-it-james/SKILL.md"
click node_stress "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/grill-me/SKILL.md"
click node_options "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/give-me-solutions/SKILL.md"
click node_reframe "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/zoom-out/SKILL.md"
click node_coaching "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/coach-me/SKILL.md"
click node_deliverables "https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/skills"
click node_engineering "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/proactive-dev/SKILL.md"
click node_project "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/project-standard/SKILL.md"
click node_catchup "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/catchup/SKILL.md"
click node_ux "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/SKILL.md"
click node_knowledge_skill "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/baseon/SKILL.md"
click node_library "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/baseon/scripts/knowledge_library.py"
click node_packs "https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/packs/knowledge"
click node_mcp "https://github.com/theeranon/jamesskills/blob/main/mcp-server/server.py"
click node_grill_builder "https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/grill-me/scripts/build_session.py"
click node_snapshot "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/catchup/scripts/project_snapshot.py"
click node_standard_tool "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/project-standard/scripts/project_standard.py"
click node_outcome_lint "https://github.com/theeranon/jamesskills/blob/main/plugins/james-core/skills/make-it-james/scripts/lint_outcome.py"
click node_ux_lint "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/scripts/lint_outcome.py"
click node_font_embed "https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/scripts/embed_ibm_plex_thai.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_core,node_productivity,node_software,node_decision,node_execution,node_quality,node_stress,node_options,node_reframe,node_coaching,node_deliverables,node_engineering,node_project,node_catchup,node_ux toneBlue
class node_knowledge_skill,node_library,node_packs toneAmber
class node_mcp toneMint
class node_grill_builder,node_snapshot,node_standard_tool,node_outcome_lint,node_ux_lint,node_font_embed toneRose
class node_person toneIndigo
```

## Components

### Skill pillars

- [Core workflows](https://github.com/theeranon/jamesskills/tree/main/plugins/james-core/skills): `plugins/james-core/skills`
- [Productivity workflows](https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/skills): `plugins/james-productivity/skills`
- [Software workflows](https://github.com/theeranon/jamesskills/tree/main/plugins/james-software/skills): `plugins/james-software/skills`
- [Decision gates](https://github.com/theeranon/jamesskills/tree/main/plugins/james-core/skills): `plugins/james-core/skills`
- [Task execution](https://github.com/theeranon/jamesskills/blob/main/plugins/james-core/skills/done-for-me/SKILL.md): `plugins/james-core/skills/done-for-me/SKILL.md`
- [Output standard](https://github.com/theeranon/jamesskills/blob/main/plugins/james-core/skills/make-it-james/SKILL.md): `plugins/james-core/skills/make-it-james/SKILL.md`
- [Interactive stress-test](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/grill-me/SKILL.md): `plugins/james-productivity/skills/grill-me/SKILL.md`
- [Options research](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/give-me-solutions/SKILL.md): `plugins/james-productivity/skills/give-me-solutions/SKILL.md`
- [System reframing](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/zoom-out/SKILL.md): `plugins/james-productivity/skills/zoom-out/SKILL.md`
- [Coaching](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/coach-me/SKILL.md): `plugins/james-productivity/skills/coach-me/SKILL.md`
- [Meeting and briefs](https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/skills): `plugins/james-productivity/skills`
- [Engineering method](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/proactive-dev/SKILL.md): `plugins/james-software/skills/proactive-dev/SKILL.md`
- [Project contract](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/project-standard/SKILL.md): `plugins/james-software/skills/project-standard/SKILL.md`
- [Project recovery](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/catchup/SKILL.md): `plugins/james-software/skills/catchup/SKILL.md`
- [Interface standards](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/SKILL.md): `plugins/james-software/skills/make-it-james-ux/SKILL.md`

### Knowledge lenses

- [Knowledge lens skill](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/baseon/SKILL.md): `plugins/james-productivity/skills/baseon/SKILL.md`
- [Lens library](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/baseon/scripts/knowledge_library.py): `plugins/james-productivity/skills/baseon/scripts/knowledge_library.py`
- [Lens packs](https://github.com/theeranon/jamesskills/tree/main/plugins/james-productivity/packs/knowledge): `plugins/james-productivity/packs/knowledge`

### Host interfaces

- [MCP tools](https://github.com/theeranon/jamesskills/blob/main/mcp-server/server.py): `mcp-server/server.py`

### Workflow support

- [Session builder](https://github.com/theeranon/jamesskills/blob/main/plugins/james-productivity/skills/grill-me/scripts/build_session.py): `plugins/james-productivity/skills/grill-me/scripts/build_session.py`
- [Git snapshot](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/catchup/scripts/project_snapshot.py): `plugins/james-software/skills/catchup/scripts/project_snapshot.py`
- [Contract utility](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/project-standard/scripts/project_standard.py): `plugins/james-software/skills/project-standard/scripts/project_standard.py`
- [Output lint](https://github.com/theeranon/jamesskills/blob/main/plugins/james-core/skills/make-it-james/scripts/lint_outcome.py): `plugins/james-core/skills/make-it-james/scripts/lint_outcome.py`
- [UX lint](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/scripts/lint_outcome.py): `plugins/james-software/skills/make-it-james-ux/scripts/lint_outcome.py`
- [Font embedding](https://github.com/theeranon/jamesskills/blob/main/plugins/james-software/skills/make-it-james-ux/scripts/embed_ibm_plex_thai.py): `plugins/james-software/skills/make-it-james-ux/scripts/embed_ibm_plex_thai.py`

### Other components

- **AI collaborator**

## Connections

- AI collaborator → Core workflows: invokes (evidence: `README.md`)
- AI collaborator → Productivity workflows: invokes (evidence: `README.md`)
- AI collaborator → Software workflows: invokes (evidence: `README.md`)
- Productivity workflows → Knowledge lens skill: applies lens (evidence: `README.md`)
- Knowledge lens skill → Lens library: queries library
- Lens library → Lens packs: reads packs
- AI collaborator → MCP tools: calls tools (evidence: `mcp-server/server.py`)
- MCP tools → Session builder: launches session
- Interactive stress-test → Session builder: builds session (evidence: `plugins/james-productivity/skills/grill-me/scripts/build_session.py`)
- Project recovery → Git snapshot: captures state
- Project contract → Contract utility: uses utility
- Output standard → Output lint: checks output
- Interface standards → UX lint: checks interface
- Interface standards → Font embedding: embeds fonts