# Project Overview > This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. - Skill: `tools-only/project-overview-18` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add tools-only/project-overview-18` - Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/project-overview-18/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tools-only (https://skillmd.com/u/tools-only) - Updated: 2026-09-29 - Page: https://skillmd.com/skills/tools-only/project-overview-18 --- # 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) ```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/
development-skills/ devtools-skills/
diagram-skills/ document-skills/
git-github-skills/ media-skills/
obsidian-skills/ skill-meta-skills/"] skill_md["SKILL.md format"] skill_dirs["config/ tips/ references/
scripts/ cookbook/"] end subgraph Commands["commands/"] claude_cmd["claude/ (.md)"] gemini_cmd["gemini/ (.toml)"] other_cmd["antigravity/ windsurf/
trae/ qwen/"] end subgraph Agents["agents/"] ccw["ccw/
Claude Code Workflow agents"] specialist["specialist/
Domain expert agents"] end prompts_dir["prompts/CLAUDE.md"] end subgraph ToolsDir["📁 tools/"] subgraph AgentKit["agentkit-desktop/"] ak_src["src/
React + TypeScript"] ak_tauri["src-tauri/
Rust backend"] end subgraph External["external-skills/"] ext_registry["registry.toml"] ext_tui["tui/
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/
Proposals & specs"] end Root --> ContentDir Root --> ToolsDir Root --> MCS Root --> OpenSpec ``` ## Module Index | Module | Path | Description | Local CLAUDE.md | |--------|------|-------------|-----------------| | **Rust TUI** | `mcs/` | Rust-based interactive installer (ratatui) | ✅ | | **Skills** | `content/skills/` | Categorized skill definitions (10 categories) | - | | **Commands** | `content/commands/` | Platform-specific slash commands | - | | **Agents** | `content/agents/` | AI agent definitions (CCW + Specialist) | ✅ | | **Prompts** | `content/prompts/` | Global prompt configuration | - | | **AgentKit Desktop** | `tools/agentkit-desktop/` | Tauri + React desktop app | ✅ | | **External Skills** | `tools/external-skills/` | External skill registry & installer | ✅ | | **Plugin Scripts** | `tools/plugin-scripts/` | Claude plugin installer scripts | - | | **OpenSpec** | `openspec/` | Change proposal system | - | | **Docs** | `docs/` | VitePress documentation site | - | ## Common Commands ```bash # 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///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//`**: 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 | Target | Skills Path | Commands Path | |--------|-------------|---------------| | claude | `~/.claude/skills/` | `~/.claude/commands/` | | codex | `~/.codex/skills/` | `~/.codex/prompts/` | | cursor | `~/.cursor/skills/` | `~/.cursor/commands/` | | gemini | `~/.gemini/skills/` | `~/.gemini/commands/` | | qwen | `~/.qwen/skills/` | `~/.qwen/commands/` | | qoder | `~/.qoder/skills/` | `~/.qoder/commands/` | | antigravity | `~/.gemini/antigravity/skills/` | `~/.gemini/antigravity/workflows/` | | windsurf | `~/.codeium/windsurf/skills/` | `~/.codeium/windsurf/workflows/` | | trae | `~/.trae/skills/` | `~/.trae/commands/` | | trae-cn | `~/.trae-cn/skills/` | `~/.trae-cn/commands/` | | opencode | `~/.config/opencode/skills/` | `~/.config/opencode/commands/` | ## Skill Definition Format ```yaml --- 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) | Category | Folder | Skills | |----------|--------|--------| | **Academic** | `academic-skills/` | `latex-paper-en`, `latex-thesis-zh`, `typst-paper`, `IEEE-writing-skills` | | **AI & LLM** | `ai-llm-skills/` | `codex`, `gemini`, `gemini-image`, `research` | | **Development** | `development-skills/` | `frontend-engineer`, `rust-cli-tui-developer`, `lib-slint-expert` | | **Dev Tools** | `devtools-skills/` | `review-code`, `memory-system`, `planning-with-files` | | **Diagrams** | `diagram-skills/` | `drawio`, `excalidraw`, `mermaid_expert` | | **Documentation** | `document-skills/` | `document-writer`, `tech-blog`, `docx`, `pdf` | | **Git & GitHub** | `git-github-skills/` | `git-commit-cn`, `gh-bootstrap`, `gh-fix-ci` | | **Media** | `media-skills/` | `article-cover`, `yt-dlp` | | **Obsidian** | `obsidian-skills/` | `obsidian-cli`, `obsidian-markdown`, `json-canvas` | | **Skill Dev** | `skill-meta-skills/` | `skill-seekers`, `github-to-skills`, `mcp-to-skill` | ## 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