# mikubaka88/ccfa-skills architecture

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

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

## Overview

CCFA Skills is a family of specialized research-paper skills, not a single application with a fixed execution pipeline. A researcher brings a task; shared humanization and coordination guidance precede the relevant skill, which produces its task-specific work. Major capabilities span ideation, literature and experiments, writing and review, figures, and submission. The README documents this coordination and task coverage, but the sampled source does not establish detailed runtime call chains between most skills; those links are therefore shown only where documented.

Main entry points: [`ccf-common/SKILL.md`](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-common/SKILL.md) (Shared coordination), [`ccf-humanization/SKILL.md`](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-humanization/SKILL.md) (Humanization), [`ccf-visual-composer`](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-visual-composer) (Visual composition), [`ccf-pipeline-orchestrator`](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-pipeline-orchestrator) (Pipeline planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Shared foundation"]
  node_humanization["Humanization<br/>[SKILL.md]"]
  node_common["Shared coordination<br/>[SKILL.md]"]
  node_orchestrator["Pipeline planning"]
  node_scaffolder["Project setup"]
end

subgraph group_research["Research development"]
  node_idea_review["Idea review<br/>[SKILL.md]"]
  node_idea_optimize["Idea development<br/>[SKILL.md]"]
end

subgraph group_evidence["Evidence work"]
  node_literature_search["Literature search"]
  node_literature_monitor["Literature monitoring"]
  node_experiment["Experiment design<br/>[SKILL.md]"]
  node_integrity["Integrity audit<br/>[SKILL.md]"]
end

subgraph group_manuscript["Paper development"]
  node_paper_review["Paper review"]
  node_paper_writer["Paper writing"]
  node_rebuttal["Rebuttal writing"]
  node_exemplar["Exemplar learning"]
end

subgraph group_delivery["Delivery and upkeep"]
  node_visual["Visual composition"]
  node_plot_recipes["Plot recipes"]
  node_submission["Submission checks"]
  node_skill_forge["Skill maintenance"]
end

node_researcher(("Researcher"))

node_researcher -->|"starts with"| node_humanization
node_humanization -->|"enables rules"| node_common
node_common -.->|"coordinates"| node_orchestrator
node_common -.->|"routes tasks"| node_scaffolder
node_common -->|"routes tasks"| node_idea_review
node_common -->|"routes tasks"| node_idea_optimize
node_common -->|"routes tasks"| node_literature_search
node_common -->|"routes tasks"| node_literature_monitor
node_common -->|"routes tasks"| node_experiment
node_common -->|"routes tasks"| node_integrity
node_common -->|"routes tasks"| node_paper_review
node_common -->|"routes tasks"| node_paper_writer
node_common -->|"routes tasks"| node_rebuttal
node_common -->|"routes tasks"| node_exemplar
node_common -->|"routes tasks"| node_visual
node_common -->|"routes tasks"| node_submission
node_common -->|"routes tasks"| node_skill_forge
node_visual -->|"uses recipes"| node_plot_recipes

click node_humanization "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-humanization/SKILL.md"
click node_common "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-common/SKILL.md"
click node_orchestrator "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-pipeline-orchestrator"
click node_scaffolder "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-project-scaffolder"
click node_idea_review "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-idea-reviewer/SKILL.md"
click node_idea_optimize "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-idea-optimizer/SKILL.md"
click node_literature_search "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-literature-searcher"
click node_literature_monitor "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-literature-monitor"
click node_experiment "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-experiment-designer/SKILL.md"
click node_integrity "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-integrity-auditor/SKILL.md"
click node_paper_review "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-paper-reviewer"
click node_paper_writer "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-paper-writer"
click node_rebuttal "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-rebuttal-writer"
click node_exemplar "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-paper-to-exemplar"
click node_visual "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-visual-composer"
click node_plot_recipes "https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-visual-composer/resources/python/ccfa_plot_recipes.py"
click node_submission "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-submission-checker"
click node_skill_forge "https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-skill-forger"

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_humanization,node_common,node_orchestrator,node_scaffolder toneBlue
class node_idea_review,node_idea_optimize toneAmber
class node_literature_search,node_literature_monitor,node_experiment,node_integrity toneMint
class node_paper_review,node_paper_writer,node_rebuttal,node_exemplar toneRose
class node_visual,node_plot_recipes,node_submission,node_skill_forge,node_researcher toneIndigo
```

## Components

### Shared foundation

- [Humanization](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-humanization/SKILL.md): `ccf-humanization/SKILL.md`
- [Shared coordination](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-common/SKILL.md): `ccf-common/SKILL.md`
- [Pipeline planning](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-pipeline-orchestrator): `ccf-pipeline-orchestrator`
- [Project setup](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-project-scaffolder): `ccf-project-scaffolder`

### Research development

- [Idea review](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-idea-reviewer/SKILL.md): `ccf-idea-reviewer/SKILL.md`
- [Idea development](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-idea-optimizer/SKILL.md): `ccf-idea-optimizer/SKILL.md`

### Evidence work

- [Literature search](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-literature-searcher): `ccf-literature-searcher`
- [Literature monitoring](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-literature-monitor): `ccf-literature-monitor`
- [Experiment design](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-experiment-designer/SKILL.md): `ccf-experiment-designer/SKILL.md`
- [Integrity audit](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-integrity-auditor/SKILL.md): `ccf-integrity-auditor/SKILL.md`

### Paper development

- [Paper review](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-paper-reviewer): `ccf-paper-reviewer`
- [Paper writing](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-paper-writer): `ccf-paper-writer`
- [Rebuttal writing](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-rebuttal-writer): `ccf-rebuttal-writer`
- [Exemplar learning](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-paper-to-exemplar): `ccf-paper-to-exemplar`

### Delivery and upkeep

- [Visual composition](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-visual-composer): `ccf-visual-composer`
- [Plot recipes](https://github.com/mikubaka88/ccfa-skills/blob/main/ccf-visual-composer/resources/python/ccfa_plot_recipes.py): `ccf-visual-composer/resources/python/ccfa_plot_recipes.py`
- [Submission checks](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-submission-checker): `ccf-submission-checker`
- [Skill maintenance](https://github.com/mikubaka88/ccfa-skills/tree/main/ccf-skill-forger): `ccf-skill-forger`

### Other components

- **Researcher**

## Connections

- Researcher → Humanization: starts with (evidence: `README.md`)
- Humanization → Shared coordination: enables rules (evidence: `README.md`)
- Shared coordination → Pipeline planning: coordinates
- Shared coordination → Project setup: routes tasks
- Shared coordination → Idea review: routes tasks (evidence: `README.md`)
- Shared coordination → Idea development: routes tasks (evidence: `README.md`)
- Shared coordination → Literature search: routes tasks (evidence: `README.md`)
- Shared coordination → Literature monitoring: routes tasks (evidence: `README.md`)
- Shared coordination → Experiment design: routes tasks (evidence: `README.md`)
- Shared coordination → Integrity audit: routes tasks (evidence: `README.md`)
- Shared coordination → Paper review: routes tasks (evidence: `README.md`)
- Shared coordination → Paper writing: routes tasks (evidence: `README.md`)
- Shared coordination → Rebuttal writing: routes tasks (evidence: `README.md`)
- Shared coordination → Exemplar learning: routes tasks (evidence: `README.md`)
- Shared coordination → Visual composition: routes tasks (evidence: `README.md`)
- Shared coordination → Submission checks: routes tasks (evidence: `README.md`)
- Shared coordination → Skill maintenance: routes tasks (evidence: `README.md`)
- Visual composition → Plot recipes: uses recipes (evidence: `README.md`)