claude-workspace

Organize .claude workspace files with enforced categories, naming, and INDEX updates.

Updated Jan 1, 2026
One-click install
npx skills add https://github.com/jayteealao/blank-template --skill claude-workspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-workspace
Source: https://github.com/jayteealao/blank-template/tree/main/.claude/skills/claude-workspace
Command: npx skills add https://github.com/jayteealao/blank-template --skill claude-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures the .claude/ workspace remains consistently structured, with enforced folder layout, standardized file naming, and cross-references to codebase files and related documentation.

Core Features & Use Cases

  • Enforces category directories and standard file naming under .claude/ (plans, architecture, examples, research, analysis)
  • Requires every file to include at least one link to a codebase file and cross-reference related documents
  • Auto-updates INDEX.md per category and supports validation/migration workflows
  • Provides intake and routing prompts for creating new files and migrating existing ones
  • Supports on-demand file types in scripts/references/assets as needed

Quick Start

Create or organize files within the .claude/ workspace using predefined categories (plans, architecture, examples, research, analysis) and update INDEX accordingly.

Frequently Asked Questions about claude-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize my Claude workspace to prevent file fragmentation?

Organize your Claude workspace by enforcing standard category directories like plans, architecture, and research. This prevents fragmentation by applying consistent naming conventions and cross-referencing codebase files.

How do I create consistent folder structures for AI project documentation?

Create consistent folder structures by categorizing files into predefined directories such as plans, architecture, examples, research, and analysis. Standardized file naming and frontmatter maintain this structure across your workspace.

What's the best way to cross-reference AI documentation with my codebase?

The best way to cross-reference documentation is requiring every file to include at least one link to a codebase file and cross-reference related documents. This ensures traceability and structural integrity.

Can I migrate existing unstructured files into a categorized workspace layout?

Yes, you can migrate existing files using supported validation and migration workflows. The process routes unstructured files into predefined categories and updates references to maintain workspace consistency.

How do I keep track of new documents added across multiple workspace categories?

Keep track of new documents by auto-updating an INDEX.md file per category. This maintains a consistent overview of all files within plans, architecture, examples, research, and analysis directories.

Does this workspace organization approach support on-demand scripts and assets?

Yes, this workspace organization approach supports on-demand file types. It exposes optional resources including scripts, references, and assets for specific tasks while maintaining the core directory structure.