# prone-dc302/alterlab-fc-skills architecture

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

- Interactive diagram: https://gitdiagram.com/prone-dc302/alterlab-fc-skills
- Repository: https://github.com/prone-dc302/alterlab-fc-skills

## Overview

This repository is a content pack for Claude “skills,” not a traditional application. Its architecture is mostly a curated file hierarchy that Claude Code or Claude can load as task-specific instruction modules.

1. **Root layer: repository metadata and user-facing docs**
   - The root contains project governance files (`LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md`), a top-level `README.md`, and a `CLAUDE.md` guide.
   - These files define how the pack is maintained, distributed, and used, but they do not implement runtime behavior.

2. **Primary functional units: individual skill folders**
   - The real product lives under `skills/`.
   - Each skill is isolated in its own folder and appears to be represented by a single `SKILL.md` file.
   - That makes each skill a self-contained prompt/instruction module that Claude can activate independently.

3. **Top-level skill domains as the main architecture boundary**
   - Skills are grouped into six domain families: `cdm`, `genai`, `nmc`, `pra`, `rma`, and `vcd`.
   - These domains act as the coarse-grained architecture layer, separating media-production workflows from research, PR/advertising, visual communication, and new-media tasks.

4. **Fine-grained specialization inside each domain**
   - Within each domain, every subfolder is a specific role or task type.
   - Examples include screenwriting, postproduction, media planning, research design, brand identity, podcast production, and voice cloning.
   - The architecture is modular: one folder equals one skill, which keeps responsibilities narrowly scoped.

5. **Skill content format**
   - The repeated `SKILL.md` naming strongly suggests a standardized document format for Claude instructions.
   - This means the repository is largely declarative content rather than executable code: the skill files encode behavior through structured guidance, not functions or services.

6. **Validation and quality control**
   - `scripts/validate.js` is the main automation entrypoint visible in the tree.
   - Its role is likely to check repository structure and skill-file consistency before release, acting as a build/QA gate for the content pack.

7. **Node-based tooling boundary**
   - `package.json` indicates the repo uses a JavaScript/Node toolchain for maintenance tasks.
   - The codebase itself is not a JS app; Node appears to support validation or release tooling around the skill files.

8. **Distribution model**
   - The README points users to a GitHub release ZIP, and the tree includes one ZIP artifact in `skills/pra/...`.
   - That suggests the repository serves both as source-of-truth and as packaging source for downloadable skill bundles.

9. **Runtime consumption boundary**
   - The intended consumer is Claude / Claude Code, which reads these skill folders from a local skills directory.
   - So the execution boundary is external: the repo stores content, while Claude is the runtime that interprets it.

10. **Data flow from authoring to use**
   - Authors edit skill markdown in the domain folders.
   - Validation scripts can check the pack.
   - A release artifact is published on GitHub.
   - Users download, extract, and place folders into Claude’s expected skills location.
   - Claude then uses the selected skill when prompted.

11. **No backend or database tier**
   - There is no sign of servers, APIs, persistent state, or data stores in the tree.
   - The architecture is file-centric and distribution-centric rather than service-centric.

12. **How to diagram it**
   - Show a root “documentation + governance” layer.
   - Show a “tooling/validation” layer around `scripts/validate.js` and `package.json`.
   - Show six domain clusters under `skills/`, each containing many independent `SKILL.md` units.
   - Show GitHub release packaging as the distribution path.
   - Show Claude/Claude Code as the external runtime consumer.

Overall, this repo is best understood as a modular skill library: organized by media/communications discipline, validated by lightweight Node tooling, and consumed by Claude as local instruction content.

Main entry points: [`skills`](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills) (skills/), [`skills/cdm`](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/cdm) (cdm), [`skills/vcd`](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/vcd) (vcd), [`README.md`](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/README.md) (README)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_root["Root docs"]
  node_readme["README<br/>doc<br/>[README.md]"]
  node_claude_md["CLAUDE guide<br/>doc<br/>[CLAUDE.md]"]
  node_governance["Governance<br/>policy docs"]
end

subgraph group_tooling["Tooling"]
  node_package_json["package.json<br/>node tooling<br/>[package.json]"]
  node_validate_js["validate.js<br/>validator<br/>[validate.js]"]
end

subgraph group_skills["Skills"]
  node_skills_root["skills/<br/>skill library"]
  node_cdm["cdm<br/>media production"]
  node_genai["genai<br/>generative media"]
  node_nmc["nmc<br/>new media"]
  node_pra["pra<br/>PR/ads"]
  node_rma["rma<br/>research methods"]
  node_vcd["vcd<br/>visual comms"]
  node_screenwriter["Screenwriter<br/>skill module<br/>[SKILL.md]"]
  node_postproduction["Postproduction<br/>skill module<br/>[SKILL.md]"]
  node_voice_cloner["Voice cloner<br/>skill module<br/>[SKILL.md]"]
  node_social_analyst["Social analyst<br/>skill module<br/>[SKILL.md]"]
  node_market_research["Market research<br/>skill module<br/>[SKILL.md]"]
  node_thesis_architect["Thesis architect<br/>skill module<br/>[SKILL.md]"]
  node_brand_identity["Brand identity<br/>skill module<br/>[SKILL.md]"]
  node_infographic["Infographic<br/>skill module<br/>[SKILL.md]"]
end

subgraph group_runtime["Runtime"]
  node_claude_runtime(("Claude<br/>external runtime"))
end

subgraph group_distribution["Distribution"]
  node_release_zip["Release ZIP<br/>distribution artifact"]
end

node_readme -->|"introduces"| node_skills_root
node_claude_md -->|"describes"| node_skills_root
node_governance -.->|"supports"| node_readme
node_package_json -->|"runs"| node_validate_js
node_validate_js -->|"checks"| node_skills_root
node_skills_root -->|"contains"| node_cdm
node_skills_root -->|"contains"| node_genai
node_skills_root -->|"contains"| node_nmc
node_skills_root -->|"contains"| node_pra
node_skills_root -->|"contains"| node_rma
node_skills_root -->|"contains"| node_vcd
node_cdm -->|"specializes"| node_screenwriter
node_cdm -->|"specializes"| node_postproduction
node_genai -->|"specializes"| node_voice_cloner
node_nmc -->|"specializes"| node_social_analyst
node_pra -->|"specializes"| node_market_research
node_rma -->|"specializes"| node_thesis_architect
node_vcd -->|"specializes"| node_brand_identity
node_vcd -->|"specializes"| node_infographic
node_release_zip -.->|"installed into"| node_claude_runtime
node_claude_runtime -->|"loads"| node_screenwriter
node_claude_runtime -->|"loads"| node_voice_cloner
node_claude_runtime -->|"loads"| node_thesis_architect

click node_readme "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/README.md"
click node_claude_md "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/CLAUDE.md"
click node_governance "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/LICENSE"
click node_package_json "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/package.json"
click node_validate_js "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/scripts/validate.js"
click node_skills_root "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills"
click node_cdm "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/cdm"
click node_genai "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/genai"
click node_nmc "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/nmc"
click node_pra "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/pra"
click node_rma "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/rma"
click node_vcd "https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/vcd"
click node_screenwriter "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/cdm/alterlab-cdm-screenwriter/SKILL.md"
click node_postproduction "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/cdm/alterlab-cdm-postproduction/SKILL.md"
click node_voice_cloner "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/genai/alterlab-genai-voice-cloner/SKILL.md"
click node_social_analyst "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/nmc/alterlab-nmc-social-analyst/SKILL.md"
click node_market_research "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/pra/alterlab-pra-market-research/SKILL.md"
click node_thesis_architect "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/rma/alterlab-rma-thesis-architect/SKILL.md"
click node_brand_identity "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/vcd/alterlab-vcd-brand-identity/SKILL.md"
click node_infographic "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/vcd/alterlab-vcd-infographic/SKILL.md"
click node_release_zip "https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/pra/alterlab-pra-market-research/Alter_Skills_Lab_F_3.8.zip"

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_readme,node_claude_md,node_governance toneBlue
class node_package_json,node_validate_js toneAmber
class node_skills_root,node_cdm,node_genai,node_nmc,node_pra,node_rma,node_vcd,node_screenwriter,node_postproduction,node_voice_cloner,node_social_analyst,node_market_research,node_thesis_architect,node_brand_identity,node_infographic toneMint
class node_claude_runtime toneRose
class node_release_zip toneIndigo
```

## Components

### Root docs

Repository governance and user-facing documentation

- [README](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/README.md): doc · Primary entry guide · `README.md`
- [CLAUDE guide](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/CLAUDE.md): doc · Usage and local skill-loading guidance · `CLAUDE.md`
- [Governance](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/LICENSE): policy docs · License, contribution, conduct, and security docs · `LICENSE`

### Tooling

Node-based validation and maintenance

- [package.json](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/package.json): node tooling · Repository maintenance and scripts manifest · `package.json`
- [validate.js](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/scripts/validate.js): validator · Main structure and consistency check · `scripts/validate.js`

### Skills

Skill library organized by domain

- [skills/](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills): skill library · Top-level catalog of all skill domains · `skills`
- [cdm](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/cdm): media production · Cinema/documentary production skills · `skills/cdm`
- [genai](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/genai): generative media · AI-assisted audiovisual skills · `skills/genai`
- [nmc](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/nmc): new media · Narrative, media, and web communication skills · `skills/nmc`
- [pra](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/pra): PR/ads · Public relations and advertising skills · `skills/pra`
- [rma](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/rma): research methods · Academic and research workflow skills · `skills/rma`
- [vcd](https://github.com/prone-dc302/alterlab-fc-skills/tree/main/skills/vcd): visual comms · Visual communication and design skills · `skills/vcd`
- [Screenwriter](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/cdm/alterlab-cdm-screenwriter/SKILL.md): skill module · Script and story development · `skills/cdm/alterlab-cdm-screenwriter/SKILL.md`
- [Postproduction](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/cdm/alterlab-cdm-postproduction/SKILL.md): skill module · Editing and finishing workflow · `skills/cdm/alterlab-cdm-postproduction/SKILL.md`
- [Voice cloner](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/genai/alterlab-genai-voice-cloner/SKILL.md): skill module · Synthetic voice generation · `skills/genai/alterlab-genai-voice-cloner/SKILL.md`
- [Social analyst](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/nmc/alterlab-nmc-social-analyst/SKILL.md): skill module · Social signal and audience analysis · `skills/nmc/alterlab-nmc-social-analyst/SKILL.md`
- [Market research](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/pra/alterlab-pra-market-research/SKILL.md): skill module · Research and insights workflow · `skills/pra/alterlab-pra-market-research/SKILL.md`
- [Thesis architect](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/rma/alterlab-rma-thesis-architect/SKILL.md): skill module · Thesis and proposal planning · `skills/rma/alterlab-rma-thesis-architect/SKILL.md`
- [Brand identity](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/vcd/alterlab-vcd-brand-identity/SKILL.md): skill module · Brand system and identity design · `skills/vcd/alterlab-vcd-brand-identity/SKILL.md`
- [Infographic](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/vcd/alterlab-vcd-infographic/SKILL.md): skill module · Information design and visualization · `skills/vcd/alterlab-vcd-infographic/SKILL.md`

### Runtime

External consumer that loads and interprets skills

- **Claude**: external runtime · Consumes selected skills as local instruction modules

### Distribution

Release packaging and download path

- [Release ZIP](https://github.com/prone-dc302/alterlab-fc-skills/blob/main/skills/pra/alterlab-pra-market-research/Alter_Skills_Lab_F_3.8.zip): distribution artifact · Packaged download for installation · `skills/pra/alterlab-pra-market-research/Alter_Skills_Lab_F_3.8.zip`

## Connections

- README → skills/: introduces · Explains the skill library and how to use it
- CLAUDE guide → skills/: describes · Guides local skill placement and activation
- Governance → README: supports · Repository policies underpin the public docs
- package.json → validate.js: runs · Defines the Node maintenance entrypoint
- validate.js → skills/: checks · Validates skill structure and consistency
- skills/ → cdm: contains · Top-level domain family
- skills/ → genai: contains · Top-level domain family
- skills/ → nmc: contains · Top-level domain family
- skills/ → pra: contains · Top-level domain family
- skills/ → rma: contains · Top-level domain family
- skills/ → vcd: contains · Top-level domain family
- cdm → Screenwriter: specializes · Representative media-production skill
- cdm → Postproduction: specializes · Representative media-production skill
- genai → Voice cloner: specializes · Representative generative-media skill
- nmc → Social analyst: specializes · Representative new-media skill
- pra → Market research: specializes · Representative PR/ads skill
- rma → Thesis architect: specializes · Representative research skill
- vcd → Brand identity: specializes · Representative visual-design skill
- vcd → Infographic: specializes · Representative visual-design skill
- Release ZIP → Claude: installed into · Packaged skill content is extracted for local use
- Claude → Screenwriter: loads · Runtime interprets the selected skill module
- Claude → Voice cloner: loads · Runtime interprets the selected skill module
- Claude → Thesis architect: loads · Runtime interprets the selected skill module