Claude Skill

docs

Imported from hudsonkit/arc/docs.

LLM Mart · 0 points · 1 views 87 listing impressions 0 install-command copies
Download hudsonkit-arc-docs-68898d3.zip · 2240 KB

Install

skills CLI npx skills add https://github.com/hudsonkit/arc/tree/main/docs
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install hudsonkit-arc@llmmart
Git git clone https://github.com/hudsonkit/arc.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole hudsonkit/arc collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Arc Skills

Pre-built skills for AI coding assistants working with Arc

Available Skills

arc-diagrams

Create and refine Arc diagrams and structured illustrations for products, processes, concepts, and software.

Location: skills/arc-diagrams/SKILL.md

Trigger: When a user asks for a diagram or illustration that explains a structure, process, mechanism, or relationship with editable source.

Capabilities:

  • Generate ArcDiagramData from natural language descriptions
  • Add/remove/modify nodes and connectors
  • Apply themes and styling
  • Use autoLayout to avoid hand-positioning
  • Convert between JSON and TypeScript formats
  • Choose composition patterns for request paths, boundaries, comparisons, and layered cutaways
  • Adapt bundled, editable examples in skills/arc-diagrams/examples/
  • Render and visually review the result at its intended reading size
  • Use the separate tiered isometric format when spatial layers explain the system
  • Compose a graphite panel cube when three faces explain aspects of one idea

The skill includes focused authoring references and a bounded render-and-review loop. Validation checks the source; visual inspection checks readability, routing, occlusion, and export quality. Both are part of the handoff.

Context to provide:

Arc diagram format: JSON with layout, nodes, nodeData, connectors, connectorStyles
Canonical schema: src/types/diagram.ts
JSON Schema: schemas/arc-diagram.schema.json (generated, draft-07; closed objects reject invented fields)
Validation: validateDiagram(value) -> coded Diagnostic[] with supportedFixes; MCP validate_diagram -> {ok, diagnostics}
CLI: arc check file.json --json; arc diff base.json head.json; arc render file.json --out diagram.svg --json; arc bench benchmarks/; arc schema
Valid colors: violet, emerald, blue, amber, sky, zinc, rose, orange
Valid sizes: xs, s, m, l  (NOT large/normal/small)
Valid anchors: left, right, top, bottom, topLeft, topRight, bottomLeft, bottomRight
Icons: Lucide icon names as strings (Server, Database, Monitor, Cloud, etc.)
Example: src/components/diagrams/architecture.diagram.ts

arc-editor-dev

Develop and debug the Arc editor codebase.

Trigger: When working on Arc editor source code

Context to provide:

Read CLAUDE.md first (repo root).

Arc Editor Structure:
- Routes: src/App.tsx
- Shell: src/apps/arc-editor/ (Hudson wrapper)
- Canvas: src/components/editor/ (DiagramCanvas, editorReducer.ts)
- State: EditorProvider.tsx + editorReducer.ts (useReducer)
- Schema: src/types/diagram.ts
- Validation: src/utils/diagramValidation.ts
- Icons: src/utils/iconRegistry.ts
- Sizes: src/utils/constants.ts (NODE_SIZES: xs/s/m/l)

Commands: bun run dev | bun run build | bun run lint | bun run typecheck
Stack: React 19, Vite 7, TailwindCSS 4, Hudson shell, Lucide icons

Reducer actions: docs/agent/editor-actions.agent.md
Visual verification: docs/agent/verification.agent.md

arc-export

Export Arc diagrams to various formats.

Trigger: When user wants to export or integrate Arc diagrams

Capabilities:

  • Export to TypeScript with proper types
  • Generate React component code
  • Render ASCII via renderAscii() or bin/arc-ascii.mjs
  • Render MCP SVG/PNG via render_svg and render_png (PNG needs Chrome/Chromium or ARC_CHROME; flowTime samples flow animations)
  • Render GIF/MP4 flow animations via render_animation (Chrome/Chromium plus ffmpeg)
  • Emit React component, iframe embed, or standalone HTML via render_html
  • Prepare diagrams for documentation sites

Example output (TypeScript):

import type { ArcDiagramData } from '@hudsonkit/arc'

export const systemArchitecture: ArcDiagramData = {
  layout: { width: 700, height: 400 },
  nodes: { /* x, y, size: 'm' */ },
  nodeData: { /* name, kind: 'backend' — or explicit icon/color overrides */ },
  connectors: [ /* ... */ ],
  connectorStyles: { /* ... */ }
}

Installing Skills

Install Arc's diagram skill with the open Skills CLI:

npx skills add hudsonkit/arc --skill arc-diagrams

The installer detects supported coding agents and places the skill in their expected project directories.

Manual setup

Point agents at:

  • CLAUDE.md — full contributor context
  • docs/llm.txt — dense briefing
  • skills/arc-diagrams/SKILL.md — diagram generation

Generic LLM

Copy docs/llm.txt or fetch /llms.txt from a running dev server.


Prompt Templates

See docs/prompts/:

  • create-diagram.md — generate from description
  • add-node.md — modify existing diagram
  • export-diagram.md — export workflows
  • debug-editor.md — editor debugging
  • modify-styling.md — themes and styling

MCP

Available via the arc-mcp bin on @hudsonkit/arc-mcp. See docs/agent/mcp.agent.md.

Files (arc)
  • agent
    • api.agent.md 6.4 KB
      Loading…
    • architecture.agent.md 4.5 KB
      Loading…
    • editor-actions.agent.md 4.1 KB
      Loading…
    • exe-dev.agent.md 3.3 KB
      Loading…
    • mcp.agent.md 12.7 KB
      Loading…
    • overview.agent.md 2.4 KB
      Loading…
    • packages.agent.md 2.5 KB
      Loading…
    • quickstart.agent.md 3 KB
      Loading…
    • verification.agent.md 2.3 KB
      Loading…
  • prompts
    • add-node.md 1.7 KB
      Loading…
    • create-diagram.md 848 B
      Loading…
    • debug-editor.md 1.1 KB
      Loading…
    • export-diagram.md 691 B
      Loading…
    • modify-styling.md 734 B
      Loading…
  • screenshots
    • prompt-agents.png 255.4 KB · in bundle
    • prompt-architecture.png 238.8 KB · in bundle
    • prompt-diagram-format.png 244.6 KB · in bundle
    • prompt-overview.png 273.1 KB · in bundle
    • prompt-quickstart.png 248.9 KB · in bundle
    • prompt-skills-fixed.png 227.1 KB · in bundle
    • prompt-skills.png 227.5 KB · in bundle
    • prompt-templates.png 245.4 KB · in bundle
    • prompt-themes.png 247.4 KB · in bundle
  • agentic-loop.md 5.1 KB
    Loading…
  • AGENTS.md 10.2 KB
    Loading…
  • api.md 20.7 KB
    Loading…
  • architecture.md 1.6 KB
    Loading…
  • diff.md 2.8 KB
    Loading…
  • examples.md 6.9 KB
    Loading…
  • exports.md 3.6 KB
    Loading…
  • focus-stories.md 1.6 KB
    Loading…
  • group-layout.md 1.8 KB
    Loading…
  • intro.md 1.5 KB
    Loading…
  • live-streams.md 8 KB
    Loading…
  • llm.txt 17.4 KB
    Loading…
  • mermaid-import.md 3 KB
    Loading…
  • mermaid-sequences.md 2.6 KB
    Loading…
  • overview.md 2.4 KB
    Loading…
  • quickstart.md 2.6 KB
    Loading…
  • saved-reviews.md 12.5 KB
    Loading…
  • skill.md 4.7 KB
    # Arc Skills
    
    > Pre-built skills for AI coding assistants working with Arc
    
    ## Available Skills
    
    ### arc-diagrams
    
    Create and refine Arc diagrams and structured illustrations for products,
    processes, concepts, and software.
    
    **Location**: `skills/arc-diagrams/SKILL.md`
    
    **Trigger**: When a user asks for a diagram or illustration that explains a
    structure, process, mechanism, or relationship with editable source.
    
    **Capabilities**:
    - Generate `ArcDiagramData` from natural language descriptions
    - Add/remove/modify nodes and connectors
    - Apply themes and styling
    - Use `autoLayout` to avoid hand-positioning
    - Convert between JSON and TypeScript formats
    - Choose composition patterns for request paths, boundaries, comparisons, and layered cutaways
    - Adapt bundled, editable examples in `skills/arc-diagrams/examples/`
    - Render and visually review the result at its intended reading size
    - Use the separate tiered isometric format when spatial layers explain the system
    - Compose a graphite panel cube when three faces explain aspects of one idea
    
    The skill includes focused authoring references and a bounded render-and-review
    loop. Validation checks the source; visual inspection checks readability, routing,
    occlusion, and export quality. Both are part of the handoff.
    
    **Context to provide**:
    ```
    Arc diagram format: JSON with layout, nodes, nodeData, connectors, connectorStyles
    Canonical schema: src/types/diagram.ts
    JSON Schema: schemas/arc-diagram.schema.json (generated, draft-07; closed objects reject invented fields)
    Validation: validateDiagram(value) -> coded Diagnostic[] with supportedFixes; MCP validate_diagram -> {ok, diagnostics}
    CLI: arc check file.json --json; arc diff base.json head.json; arc render file.json --out diagram.svg --json; arc bench benchmarks/; arc schema
    Valid colors: violet, emerald, blue, amber, sky, zinc, rose, orange
    Valid sizes: xs, s, m, l  (NOT large/normal/small)
    Valid anchors: left, right, top, bottom, topLeft, topRight, bottomLeft, bottomRight
    Icons: Lucide icon names as strings (Server, Database, Monitor, Cloud, etc.)
    Example: src/components/diagrams/architecture.diagram.ts
    ```
    
    ---
    
    ### arc-editor-dev
    
    Develop and debug the Arc editor codebase.
    
    **Trigger**: When working on Arc editor source code
    
    **Context to provide**:
    ```
    Read CLAUDE.md first (repo root).
    
    Arc Editor Structure:
    - Routes: src/App.tsx
    - Shell: src/apps/arc-editor/ (Hudson wrapper)
    - Canvas: src/components/editor/ (DiagramCanvas, editorReducer.ts)
    - State: EditorProvider.tsx + editorReducer.ts (useReducer)
    - Schema: src/types/diagram.ts
    - Validation: src/utils/diagramValidation.ts
    - Icons: src/utils/iconRegistry.ts
    - Sizes: src/utils/constants.ts (NODE_SIZES: xs/s/m/l)
    
    Commands: bun run dev | bun run build | bun run lint | bun run typecheck
    Stack: React 19, Vite 7, TailwindCSS 4, Hudson shell, Lucide icons
    
    Reducer actions: docs/agent/editor-actions.agent.md
    Visual verification: docs/agent/verification.agent.md
    ```
    
    ---
    
    ### arc-export
    
    Export Arc diagrams to various formats.
    
    **Trigger**: When user wants to export or integrate Arc diagrams
    
    **Capabilities**:
    - Export to TypeScript with proper types
    - Generate React component code
    - Render ASCII via `renderAscii()` or `bin/arc-ascii.mjs`
    - Render MCP SVG/PNG via `render_svg` and `render_png` (PNG needs Chrome/Chromium or `ARC_CHROME`; `flowTime` samples flow animations)
    - Render GIF/MP4 flow animations via `render_animation` (Chrome/Chromium plus ffmpeg)
    - Emit React component, iframe embed, or standalone HTML via `render_html`
    - Prepare diagrams for documentation sites
    
    **Example output** (TypeScript):
    ```typescript
    import type { ArcDiagramData } from '@hudsonkit/arc'
    
    export const systemArchitecture: ArcDiagramData = {
      layout: { width: 700, height: 400 },
      nodes: { /* x, y, size: 'm' */ },
      nodeData: { /* name, kind: 'backend' — or explicit icon/color overrides */ },
      connectors: [ /* ... */ ],
      connectorStyles: { /* ... */ }
    }
    ```
    
    ---
    
    ## Installing Skills
    
    Install Arc's diagram skill with the open Skills CLI:
    
    ```bash
    npx skills add hudsonkit/arc --skill arc-diagrams
    ```
    
    The installer detects supported coding agents and places the skill in their
    expected project directories.
    
    ### Manual setup
    
    Point agents at:
    - `CLAUDE.md` — full contributor context
    - `docs/llm.txt` — dense briefing
    - `skills/arc-diagrams/SKILL.md` — diagram generation
    
    ### Generic LLM
    
    Copy `docs/llm.txt` or fetch `/llms.txt` from a running dev server.
    
    ---
    
    ## Prompt Templates
    
    See `docs/prompts/`:
    - `create-diagram.md` — generate from description
    - `add-node.md` — modify existing diagram
    - `export-diagram.md` — export workflows
    - `debug-editor.md` — editor debugging
    - `modify-styling.md` — themes and styling
    
    ---
    
    ## MCP
    
    Available via the `arc-mcp` bin on `@hudsonkit/arc-mcp`. See `docs/agent/mcp.agent.md`.
    
  • themes.md 3.9 KB
    Loading…
  • views.md 3 KB
    Loading…

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.