Update Workspace Map

Validate workspace-map.md accuracy against actual 04-workspace/ structure (3 levels deep). Load when user says "validate workspace map", "update workspace map", "check workspace map", or from close-session. Ensures deep structure validation with comprehensive documentation.

8 stars 3 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Freddy-CHEN-ux/00_claude_skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Freddy-CHEN-ux/00_claude_skills --skill update-workspace-map
Manual install
git clone --depth 1 https://github.com/Freddy-CHEN-ux/00_claude_skills.git /tmp/00_claude_skills
mkdir -p ~/.claude/skills
cp -r /tmp/00_claude_skills/skills/update-workspace-map ~/.claude/skills/update-workspace-map

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Validate Workspace Map

Ensure workspace-map.md stays synchronized with actual 04-workspace/ folder structure up to 3 levels deep.

## Purpose

The workspace-map.md file helps AI understand your custom folder organization in 04-workspace/. When it becomes stale (folders added/removed/reorganized but not documented), AI navigation becomes unreliable.

This skill:
- Scans workspace structure **3 levels deep** (root → level 1 → level 2 → level 3)
- Compares actual folders with documented folders at all levels
- Identifies mismatches (missing or extra folders, incorrect nesting)
- Provides detailed structure report with depth indicators
- Guides you through comprehensive updates
- Validates accuracy after changes

**Improvements over v1**:
- ✅ **3-layer deep scanning** (vs 1 layer)
- ✅ **Hierarchical validation** (parent-child relationships)
- ✅ **File detection** (warns about files that should be documented)
- ✅ **Depth indicators** in reports (├──, │  ├──, │  │  ├──)
- ✅ **Comprehensive documentation** prompts for nested structures

**When to use**:
- You reorganized 04-workspace/ folders
- You notice AI can't find your folders
- During onboarding (Project 03, Task 5.6)
- As part of regular maintenance (via close-session)

---

## Workflow

### Step 1: Scan Actual Workspace Structure (3 Levels Deep)

**Scan workspace recursively** (up to 3 levels):
```bash
find 04-workspace -maxdepth 3 -type d | sort
```

**Parse into hierarchical structure**:
Read the full skill on GitHub

Details

Skill name
update-workspace-map
Path
skills/update-workspace-map/SKILL.md
Repo updated
10 January 2026

FAQ

What does the Update Workspace Map skill do?

Validate workspace-map.md accuracy against actual 04-workspace/ structure (3 levels deep). Load when user says "validate workspace map", "update workspace map", "check workspace map", or from close-session. Ensures deep structure validation with comprehensive documentation.

How do I install the Update Workspace Map skill?

Claude Code plugin: /plugin marketplace add Freddy-CHEN-ux/00_claude_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Update Workspace Map popular?

It lives in Freddy-CHEN-ux/00_claude_skills, which has 8 GitHub stars and 3 forks.

Related skills

Add Integration

8

Freddy-CHEN-ux/00_claude_skills

Build a new API integration for Nexus. Load when user mentions "add integration", "new integration", "integrate with", "connect to [service]", or "build [service] integration". Interactive workflow that discovers API endpoints, plans the integration, and creates a project for implementation.

Software Development

AI Agents

8

Freddy-CHEN-ux/00_claude_skills

Production-grade AI agent patterns with MCP integration, agentic RAG, handoff orchestration, multi-layer guardrails, and observability (modern best practices)

AI, LLMs & Agents

AI LLM

8

Freddy-CHEN-ux/00_claude_skills

Production LLM engineering skill. Covers strategy selection (prompting vs RAG vs fine-tuning), dataset design, PEFT/LoRA, evaluation workflows, deployment handoff to inference serving, and lifecycle operations with cost/safety controls.

AI, LLMs & Agents

User Story Mapping

5

vnovakovits/claude-skills

Apply Jeff Patton's User Story Mapping (O'Reilly, 2014) — arranging user stories into a two-dimensional map that preserves the user's narrative journey, which a flat backlog destroys. Covers the map's anatomy (backbone and ribs; activities, tasks, details), the two axes (narrative flow left-to-right, priority/necessity top-to-bottom), the core philosophy (shared understanding over documents; minimize output, maximize outcome and impact), running a mapping workshop (frame, map breadth-first, explore alternatives/exceptions, distill a backbone, slice), slicing releases into a walking-skeleton MV

Writing & Content

Ticket Writer

5

vnovakovits/claude-skills

Draft, write, structure, or improve engineering tickets — user stories, bug reports, spikes, feature requests — for any tracker (Jira, Linear, GitHub Issues, Shortcut, Asana). Enforces a problem-first structure (outcome → context → constraints → acceptance criteria → dependencies → open questions) drawn from Daniel Starling's "Anatomy of a Software Ticket", Bill Wake's INVEST and SMART, and Marty Cagan / SVPG's "Empowered Product Teams". Actively rejects the standard anti-patterns — prescribed solutions / "files to change", missing outcome, untestable acceptance criteria, PM-supplied estimates

Writing & Content

Validate Docs Implementation

8

Freddy-CHEN-ux/00_claude_skills

Load when user says "validate docs", "check documentation consistency", "docs vs implementation", or "find documentation mismatches". Systematically compares implementation code against documentation to identify and fix inconsistencies.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.