obsidian

Claude Code Skills

A collection of custom skills for Claude Code that extend its capabilities for architecture documentation, diagramming, and presentation styling.

Skills

arch-describe

Plugin: architect

Generate structured IT architecture descriptions with ASCII diagrams from short prompts.

Usage: Ask Claude to describe, explain, or document the architecture of any IT system.

Output Structure:

1. Overview - System purpose and high-level architecture
2. Components - List of all components with descriptions
3. Connections - Numbered list of integrations between components
4. Diagram - ASCII diagram with annotated connections

Example:

Describe the architecture of a Kafka cluster

Includes reference documentation for 20+ common systems including Kafka, Kubernetes, PostgreSQL HA, Redis Cluster, Elasticsearch, and more.

arch-draw

Plugin: architect

Generate professional draw.io diagrams in XML format from architectural descriptions.

Usage: Ask Claude to create visual diagrams for system architecture, microservices, workflows, network topology, or data flows.

Capabilities:

• System architecture diagrams
• Microservices layouts
• Workflow/BPMN diagrams
• Network topology
• Data flow diagrams

Features:

• Grid-aligned layouts (10px grid)
• Arrow routing with collision avoidance
• Consistent color schemes
• Container/swimlane support
• Multiple architectural patterns (three-tier, event-driven, etc.)

Example:

Create a draw.io diagram for a microservices architecture with API Gateway, 3 services, message bus, and databases

pptx-core-style

Plugin: presentation

Corporate presentation style guide for core principles architecture slides. Provides a canonical visual language — color palette, typography scale, layout grid, and component styles — to use alongside the pptx skill.

Covers: NAVY/BLUE/ORANGE/STEEL color tokens, two-column layout with divider, content blocks with badges, tables with accent rows, key insight blocks, distribution bars, category descriptions with colored emphasis.

Example:

Create an architecture slide using pptx-core-style with three numbered content blocks and a comparison table

pptx-arch-style

Plugin: presentation

Architectural presentation style guide for architecture committee reviews. Defines a complete visual system adapted from a Google Slides "Modern Business" template.

Covers: title/section/content slide layouts, page number badge + red accent line, semantic status colors (done/planned/not verified), three table styles (checklist, status tracker, data), content boxes, numbered circles, category cards with left accent, stat callout funnels, flow and decision tree diagram conventions.

Example:

Create an architecture review deck using pptx-arch-style with a title slide, status tracker table, and flow diagram

offdesk

Plugin: obsidian

Push markdown files from any project into a Syncthing-synced Obsidian vault on phone/tablet for off-desk reading, then pull annotated >[!ai] callouts back to the source file. P2P only — no cloud, no bot.

Usage: Ask Claude to send a doc to offdesk for review, or to check feedback from your phone.

Example:

положи это в offdesk
посмотри оффдеск фидбэк

books

Plugin: reading

Push markdown files from any project to Apple Books on iPad as PDF for off-desk reading with Apple Pencil annotations. iCloud Drive → tap to open in Books. Push-only — pen marks stay with the human.

Usage: Ask Claude to send a doc to books for review on iPad.

Example:

send to books
положи это в books
почитаю на айпаде

Project Structure

Skills are grouped by domain under plugins/architect/skills/, plugins/presentation/skills/, plugins/obsidian/skills/, and plugins/reading/skills/: