# adrianpunk/punk-skill architecture

> Architecture diagram of the GitHub repository adrianpunk/punk-skill, 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/adrianpunk/punk-skill
- Repository: https://github.com/adrianpunk/punk-skill

## Overview

Punk Skill is a collection of AI-agent instructions for turning text or images into cover and avatar-generation prompts. The documented flow is a user request handled by a host agent, which follows the selected skill, consults its prompt blueprint and catalogs, and applies a style before generating an image or returning prompt-only output. The README documents both skill tracks and their major options; sampled source was limited to validation scripts, so internal prompt-construction details and tool wiring are not independently verified.

Main entry points: [`skills/punk-cover/SKILL.md`](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/SKILL.md) (Cover Instructions), [`skills/punk-avatar/SKILL.md`](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/SKILL.md) (Avatar Instructions), [`styles`](https://github.com/adrianpunk/punk-skill/tree/main/styles) (Style Definitions), [`skills/punk-cover/references/cover-prompt-blueprint.md`](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/cover-prompt-blueprint.md) (Cover Blueprint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cover["Cover Skill"]
  node_cover_skill["Cover Instructions<br/>[SKILL.md]"]
  node_cover_blueprint["Cover Blueprint"]
  node_platform_catalog["Platform Catalog"]
  node_cover_catalog["Cover Style Catalog<br/>[style-catalog.md]"]
end

subgraph group_avatar["Avatar Skill"]
  node_avatar_skill["Avatar Instructions<br/>[SKILL.md]"]
  node_avatar_blueprint["Avatar Blueprint"]
  node_avatar_catalog["Avatar Style Catalog<br/>[style-catalog.md]"]
end

subgraph group_shared["Style Library"]
  node_style_docs["Style Definitions"]
end

node_user(("User"))
node_agent(("AI Agent"))
node_image_tool{{"Image Generation Tool"}}
node_generated_image["Generated Image"]
node_prompt_output["Prompt Output"]

node_user -->|"requests artwork"| node_agent
node_agent -->|"invokes cover"| node_cover_skill
node_agent -->|"invokes avatar"| node_avatar_skill
node_cover_skill -->|"consults"| node_cover_blueprint
node_cover_skill -->|"consults"| node_platform_catalog
node_cover_skill -->|"consults"| node_cover_catalog
node_cover_skill -->|"applies style"| node_style_docs
node_avatar_skill -->|"consults"| node_avatar_blueprint
node_avatar_skill -->|"consults"| node_avatar_catalog
node_avatar_skill -->|"applies style"| node_style_docs
node_cover_skill -->|"submits prompt"| node_image_tool
node_avatar_skill -->|"submits prompt"| node_image_tool
node_cover_skill -->|"returns prompt-only"| node_prompt_output
node_avatar_skill -->|"returns prompt-only"| node_prompt_output
node_image_tool -->|"generates"| node_generated_image

click node_cover_skill "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/SKILL.md"
click node_cover_blueprint "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/cover-prompt-blueprint.md"
click node_platform_catalog "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/platform-catalog.md"
click node_cover_catalog "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/style-catalog.md"
click node_avatar_skill "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/SKILL.md"
click node_avatar_blueprint "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/references/avatar-prompt-blueprint.md"
click node_avatar_catalog "https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/references/style-catalog.md"
click node_style_docs "https://github.com/adrianpunk/punk-skill/tree/main/styles"

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_cover_skill,node_cover_blueprint,node_platform_catalog,node_cover_catalog,node_user toneBlue
class node_avatar_skill,node_avatar_blueprint,node_avatar_catalog toneAmber
class node_style_docs toneMint
class node_agent,node_image_tool,node_generated_image,node_prompt_output toneIndigo
```

## Components

### Cover Skill

- [Cover Instructions](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/SKILL.md): `skills/punk-cover/SKILL.md`
- [Cover Blueprint](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/cover-prompt-blueprint.md): `skills/punk-cover/references/cover-prompt-blueprint.md`
- [Platform Catalog](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/platform-catalog.md): `skills/punk-cover/references/platform-catalog.md`
- [Cover Style Catalog](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-cover/references/style-catalog.md): `skills/punk-cover/references/style-catalog.md`

### Avatar Skill

- [Avatar Instructions](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/SKILL.md): `skills/punk-avatar/SKILL.md`
- [Avatar Blueprint](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/references/avatar-prompt-blueprint.md): `skills/punk-avatar/references/avatar-prompt-blueprint.md`
- [Avatar Style Catalog](https://github.com/adrianpunk/punk-skill/blob/main/skills/punk-avatar/references/style-catalog.md): `skills/punk-avatar/references/style-catalog.md`

### Style Library

- [Style Definitions](https://github.com/adrianpunk/punk-skill/tree/main/styles): `styles`

### Other components

- **User**
- **AI Agent**
- **Image Generation Tool**
- **Generated Image**
- **Prompt Output**

## Connections

- User → AI Agent: requests artwork
- AI Agent → Cover Instructions: invokes cover
- AI Agent → Avatar Instructions: invokes avatar
- Cover Instructions → Cover Blueprint: consults
- Cover Instructions → Platform Catalog: consults
- Cover Instructions → Cover Style Catalog: consults
- Cover Instructions → Style Definitions: applies style
- Avatar Instructions → Avatar Blueprint: consults
- Avatar Instructions → Avatar Style Catalog: consults
- Avatar Instructions → Style Definitions: applies style
- Cover Instructions → Image Generation Tool: submits prompt
- Avatar Instructions → Image Generation Tool: submits prompt
- Cover Instructions → Prompt Output: returns prompt-only
- Avatar Instructions → Prompt Output: returns prompt-only
- Image Generation Tool → Generated Image: generates