Use when creating workspace directories for agent work. Defines the canonical workspace-id format, directory structure, and file naming convention.
From mutilsnpx claudepluginhub masseater/claude-code-plugin --plugin mutilsThis skill uses the workspace's default tool permissions.
generate.tspatterns.tsGuides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Details PluginEval's skill quality evaluation: 3 layers (static, LLM judge), 10 dimensions, rubrics, formulas, anti-patterns, badges. Use to interpret scores, improve triggering, calibrate thresholds.
This skill provides the canonical format and conventions for managing agent workspaces. Use this skill when creating new workspace directories or documenting workspace-related workflows.
Workspace IDs follow a strict format to ensure consistency across all agent work:
yyyymmdd-HHmm-[feature-name]
| Component | Format | Example | Notes |
|---|---|---|---|
| Date | yyyymmdd | 20260302 | Local date, 4-digit year, 2-digit month, 2-digit day |
| Time | HHmm | 1430 | Local time in 24-hour format (hours and minutes only) |
| Feature Name | kebab-case | doc-engine | Must match regex: /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/ |
fix-parser, add-auth, refactor-utils, v2-migrationAll workspace files are organized under the .agents/workspaces/ directory:
.agents/workspaces/
└── [workspace-id]/
├── [nnnnnn]-[subagent-name]-[content].md
├── [nnnnnn]-[subagent-name]-[content].md
└── ...
The .agents/workspaces/[workspace-id]/ directory contains all reports and artifacts from a single agent work session.
Files within a workspace use a structured naming pattern:
[nnnnnn]-[subagent-name]-[content].md
| Component | Format | Example | Notes |
|---|---|---|---|
| Sequence | [nnnnnn] | 000001 | 6-digit zero-padded integer, incremented per file |
| Subagent | [subagent-name] | documentation-engineer | Identifies which subagent created the file |
| Content Type | [content] | report | Describes the file's purpose (e.g., report, review, plan) |
000001-documentation-engineer-report.md — Initial report from documentation engineer000002-code-review-assistant-review.md — Code review from code review assistant000003-api-designer-feedback.md — Feedback from API designerThe generate.ts tool generates a properly formatted workspace ID:
${CLAUDE_PLUGIN_ROOT}/skills/workspace-id/generate.ts [feature-name]
Parameters:
[feature-name] — The kebab-case feature name for your workspaceOutput:
yyyymmdd-HHmm-[feature-name]Example:
${CLAUDE_PLUGIN_ROOT}/skills/workspace-id/generate.ts doc-review
# Output: 20260302-1430-doc-review
Workspace ID: 20260302-1430-doc-engine
Directory: .agents/workspaces/20260302-1430-doc-engine/
Files:
- 000001-documentation-engineer-report.md
- 000002-technical-writer-review.md
- 000003-qa-expert-feedback.md
doc-engine — Documentation system buildingapi-v2-migration — API v2 migration workfix-type-checking — Type checking fixesadd-e2e-tests — Adding end-to-end testsrefactor-auth — Authentication refactoring❌ 20260302-14:30-doc-engine # Time format wrong (use HHmm, not HH:mm)
❌ 20260302-1430-docEngine # Feature name not kebab-case (docEngine)
❌ 20260302-1430-doc_engine # Feature name uses underscore (use hyphens)
❌ 2026-03-02-1430-doc-engine # Date format wrong (use yyyymmdd)
docEngine — Camel-case (must be kebab-case)doc_engine — Underscores (use hyphens only)DOC-ENGINE — Uppercase (must be lowercase)2-doc-engine — Starts with digit (must start with letter)doc--engine — Double hyphens (use single hyphens)❌ 1-doc-engineer-report.md # Only 1 digit (use 6)
❌ 000001-doc engineer-report.md # Space in subagent name
❌ 000001_documentation_engineer_report.md # Underscores (use hyphens)
❌ 000001-documentation-engineer # Missing .md extension
Workspace-ids generated with this skill are automatically persisted. After Auto Compact or when resuming a session, the workspace-id is restored automatically.
The rounds/ directory structure (e.g., rounds/[NNNN]/) is specific to the plan plugin and is NOT part of the general workspace-id specification. Use workspace directories as defined above for standard agent work.
When creating workspaces for plugin-specific work:
.agents/plans/ files and may organize rounds within workspaces.agents/workspaces/[workspace-id]/.agents/workspaces/[workspace-id]/.agents/workspaces/[workspace-id]/All plugins use the same canonical workspace-id format defined by this skill.