OpenSpec Instructions

OpenSpec Instructions

These instructions are for AI assistants working in this project.

Always open @/openspec/AGENTS.md when the request:

• Mentions planning or proposals (words like proposal, spec, change, plan)
• Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
• Sounds ambiguous and you need the authoritative spec before coding

Use @/openspec/AGENTS.md to learn:

• How to create and apply change proposals
• Spec format and conventions
• Project structure and guidelines

Keep this managed block so 'openspec update' can refresh the instructions.

CLAUDE.md

Last Updated: 2026-01-31 09:01:58

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

MyClaude Skills is a comprehensive collection of Claude Code skills, prompts, and workflows for AI-assisted development. It provides:

• Unified skill format (SKILL.md) with YAML frontmatter
• Cross-platform installation to multiple targets: Claude Code, Codex CLI, Gemini CLI, Qwen Code, Google Antigravity, Windsurf, Trae, and OpenCode
• Interactive Rust TUI (mcs/) for skill management
• Desktop application (AgentKit Desktop) built with Tauri + React
• External skills registry for community contributions

Project Structure (Mermaid)

graph TB
    subgraph Root["📁 my-claude-code-settings"]
        direction TB
    end

    subgraph ContentDir["📁 content/"]
        subgraph Skills["skills/ (categorized)"]
            skill_cats["academic-skills/ ai-llm-skills/<br/>development-skills/ devtools-skills/<br/>diagram-skills/ document-skills/<br/>git-github-skills/ media-skills/<br/>obsidian-skills/ skill-meta-skills/"]
            skill_md["SKILL.md format"]
            skill_dirs["config/ tips/ references/<br/>scripts/ cookbook/"]
        end

        subgraph Commands["commands/"]
            claude_cmd["claude/ (.md)"]
            gemini_cmd["gemini/ (.toml)"]
            other_cmd["antigravity/ windsurf/<br/>trae/ qwen/"]
        end

        subgraph Agents["agents/"]
            ccw["ccw/<br/>Claude Code Workflow agents"]
            specialist["specialist/<br/>Domain expert agents"]
        end

        prompts_dir["prompts/CLAUDE.md"]
    end

    subgraph ToolsDir["📁 tools/"]
        subgraph AgentKit["agentkit-desktop/"]
            ak_src["src/<br/>React + TypeScript"]
            ak_tauri["src-tauri/<br/>Rust backend"]
        end

        subgraph External["external-skills/"]
            ext_registry["registry.toml"]
            ext_tui["tui/<br/>External skill installer"]
        end

        plugin_scripts["plugin-scripts/"]
    end

    subgraph MCS["📁 mcs/"]
        mcs_rust["Rust TUI (ratatui)"]
    end

    subgraph OpenSpec["📁 openspec/"]
        os_agents["AGENTS.md"]
        os_changes["changes/<br/>Proposals & specs"]
    end

    Root --> ContentDir
    Root --> ToolsDir
    Root --> MCS
    Root --> OpenSpec

Module Index

Common Commands

# TUI mode (Rust MCS) - skill browsing and installation
just mcs

# Documentation (VitePress)
cd docs && npm install && npm run dev

# AgentKit Desktop (Tauri)
cd tools/agentkit-desktop && npm install && npm run tauri dev

# External Skills TUI
uv run python tools/external-skills/install_tui.py

# CI checks (TypeScript + Rust)
just ci

Architecture

Core Components

• mcs/: Rust TUI application (ratatui + crossterm)

  • Interactive skill browser with keyboard navigation
  • Detects project root via walk_up_for_content()

• tools/agentkit-desktop/: Tauri v2 desktop application

  • src/ - React + TypeScript frontend with Zustand stores
  • src-tauri/ - Rust backend with SQLite database
  • Features: i18n (en/zh), platform management, resource sync

• content/agents/: AI agent definitions

  • ccw/ - Claude Code Workflow agents (planning, execution, debugging)
  • specialist/ - Domain expert agents (Python, TypeScript, CSS, etc.)

• tools/external-skills/: External skill management

  • registry.toml - Skill registry with GitHub sources
  • install.py - CLI installer
  • tui/ - Interactive TUI installer

Content Structure

• content/skills/<category>/<name>/SKILL.md: Skill definitions organized in category folders (academic-skills/, ai-llm-skills/, development-skills/, devtools-skills/, diagram-skills/, document-skills/, git-github-skills/, media-skills/, obsidian-skills/, skill-meta-skills/). Each skill has YAML frontmatter (name, description, optional license). May include subdirectories: config/, tips/, references/, scripts/, cookbook/. default.toml controls which categories are installed by install-all.

• content/commands/<platform>/: Slash commands per platform

  • claude/ - Markdown files (.md) with nested directories (cc/, cli/, gh/, issue/, kiro/, memory/, task/, workflow/, zcf/)
  • gemini/ - TOML files (.toml)
  • antigravity/, windsurf/, trae/ - Markdown workflows
  • qwen/ - Qwen-specific commands

• content/prompts/CLAUDE.md: Global workflow configuration synced via prompt-update

Installation Targets

Skill Definition Format

---
name: skill-name
description: Brief description for listing
license: MIT  # optional
---

# Skill Title

Detailed instructions and documentation...

Code Conventions

• Comments in English
• Rust code follows standard Rust conventions (mcs/, tools/agentkit-desktop/src-tauri/)
• TypeScript/React follows ESLint config in tools/agentkit-desktop
• Follow existing patterns in mcs/ modules

Key Skills (Highlights)

Related Documentation

• openspec/AGENTS.md - Change proposal workflow
• tools/agentkit-desktop/DEVELOPER.md - Desktop app development guide
• tools/external-skills/README.md - External skills installation guide
• docs/ - VitePress documentation site