# bhasprocoder/skill-factory architecture

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

- Interactive diagram: https://gitdiagram.com/bhasprocoder/skill-factory
- Repository: https://github.com/bhasprocoder/skill-factory

## Overview

Skill Factory is a local library of portable, task-focused Markdown procedures, organized by domain. The principal workflow is to route a request to a domain, select one matching skill, provide it and the real inputs to an AI agent, then check the resulting artifact against that skill’s quality checklist and test assertions. The repository also provides a CLI for finding and validating skills and exporting or preparing them for use. The README documents the workflow; sampled source shows CLI responsibilities, but not every skill’s internal procedure.

Main entry points: [`tools/sf.py`](https://github.com/bhasprocoder/skill-factory/blob/main/tools/sf.py) (Skill Factory CLI), [`registry/domains.jsonl`](https://github.com/bhasprocoder/skill-factory/blob/main/registry/domains.jsonl) (Domain catalog), [`registry/skills.jsonl`](https://github.com/bhasprocoder/skill-factory/blob/main/registry/skills.jsonl) (Skill registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skill_domains["Task skill library"]
  node_business["Business and strategy"]
  node_operations["Operations and commerce"]
  node_government["Government services"]
  node_education_research["Education and research"]
  node_contracts_compliance["Contracts and compliance"]
  node_technology_data["Technology and data"]
  node_creative_media["Creative and media"]
  node_communication["Communication and writing"]
  node_personal_work["Personal workflows"]
end

subgraph group_cli["Library CLI"]
  node_sf_cli["Skill Factory CLI<br/>[sf.py]"]
end

subgraph group_records["Catalog records"]
  node_router_catalog["Domain catalog<br/>[domains.jsonl]"]
  node_skill_registry[("Skill registry<br/>[skills.jsonl]")]
end

subgraph group_integrations["External use"]
  node_ai_agent(("AI agent"))
end

node_requester(("Requester"))
node_artifact["Task artifact"]

node_requester -->|"chooses domain"| node_router_catalog
node_requester -->|"selects matching skill"| node_skill_registry
node_requester -->|"provides skill and inputs"| node_ai_agent
node_ai_agent -->|"produces result"| node_artifact
node_requester -->|"checks against skill"| node_artifact
node_sf_cli -->|"queries and updates"| node_skill_registry
node_sf_cli -->|"routes and searches"| node_router_catalog
node_sf_cli -->|"exports skills"| node_artifact

click node_business "https://github.com/bhasprocoder/skill-factory/tree/main/skills/BMD"
click node_operations "https://github.com/bhasprocoder/skill-factory/tree/main/skills/BPL"
click node_government "https://github.com/bhasprocoder/skill-factory/tree/main/skills/GIS"
click node_education_research "https://github.com/bhasprocoder/skill-factory/tree/main/skills/GAS"
click node_contracts_compliance "https://github.com/bhasprocoder/skill-factory/tree/main/skills/CTR"
click node_technology_data "https://github.com/bhasprocoder/skill-factory/tree/main/skills/TAP"
click node_creative_media "https://github.com/bhasprocoder/skill-factory/tree/main/skills/TAM"
click node_communication "https://github.com/bhasprocoder/skill-factory/tree/main/skills/GCO"
click node_personal_work "https://github.com/bhasprocoder/skill-factory/tree/main/skills/GPR"
click node_router_catalog "https://github.com/bhasprocoder/skill-factory/blob/main/registry/domains.jsonl"
click node_skill_registry "https://github.com/bhasprocoder/skill-factory/blob/main/registry/skills.jsonl"
click node_sf_cli "https://github.com/bhasprocoder/skill-factory/blob/main/tools/sf.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_business,node_operations,node_government,node_education_research,node_contracts_compliance,node_technology_data,node_creative_media,node_communication,node_personal_work toneBlue
class node_sf_cli toneAmber
class node_router_catalog,node_skill_registry,node_requester toneMint
class node_ai_agent,node_artifact toneRose
```

## Components

### Task skill library

- [Business and strategy](https://github.com/bhasprocoder/skill-factory/tree/main/skills/BMD): `skills/BMD`
- [Operations and commerce](https://github.com/bhasprocoder/skill-factory/tree/main/skills/BPL): `skills/BPL`
- [Government services](https://github.com/bhasprocoder/skill-factory/tree/main/skills/GIS): `skills/GIS`
- [Education and research](https://github.com/bhasprocoder/skill-factory/tree/main/skills/GAS): `skills/GAS`
- [Contracts and compliance](https://github.com/bhasprocoder/skill-factory/tree/main/skills/CTR): `skills/CTR`
- [Technology and data](https://github.com/bhasprocoder/skill-factory/tree/main/skills/TAP): `skills/TAP`
- [Creative and media](https://github.com/bhasprocoder/skill-factory/tree/main/skills/TAM): `skills/TAM`
- [Communication and writing](https://github.com/bhasprocoder/skill-factory/tree/main/skills/GCO): `skills/GCO`
- [Personal workflows](https://github.com/bhasprocoder/skill-factory/tree/main/skills/GPR): `skills/GPR`

### Library CLI

- [Skill Factory CLI](https://github.com/bhasprocoder/skill-factory/blob/main/tools/sf.py): `tools/sf.py`

### Catalog records

- [Domain catalog](https://github.com/bhasprocoder/skill-factory/blob/main/registry/domains.jsonl): `registry/domains.jsonl`
- [Skill registry](https://github.com/bhasprocoder/skill-factory/blob/main/registry/skills.jsonl): `registry/skills.jsonl`

### External use

- **AI agent**

### Other components

- **Requester**
- **Task artifact**

## Connections

- Requester → Domain catalog: chooses domain (evidence: `README.md`)
- Requester → Skill registry: selects matching skill (evidence: `README.md`)
- Requester → AI agent: provides skill and inputs (evidence: `README.md`)
- AI agent → Task artifact: produces result (evidence: `README.md`)
- Requester → Task artifact: checks against skill (evidence: `README.md`)
- Skill Factory CLI → Skill registry: queries and updates (evidence: `tools/sf.py`)
- Skill Factory CLI → Domain catalog: routes and searches (evidence: `tools/sf.py`)
- Skill Factory CLI → Task artifact: exports skills (evidence: `README.md`)
