workspace-organization

Use when creating, filing, moving, or archiving files in the agent workspace: which directory a file belongs in, how to date and attribute it, when to archive instead of delete, and how to keep the tree navigable over years.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-crafted, concise instruction-only skill with clear structure and highly actionable filing rules. Its only real weakness is the lack of an explicit validation/verify gate around destructive batch operations.

Suggestions

Add an explicit validation step for destructive or batch operations, e.g. 'Before archiving a batch, confirm the destination paths and write a manifest; only then move files.'

Provide a concrete manifest template (fields like destination, original_path, resolved_date, date_source) so the bulk-import workflow is copy-paste ready.

Clarify the housekeeping checkpoint into a numbered sequence (check saved/ → find Untitled files → clear ingest/) with an explicit completion signal.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence: no padding, no explanations of basic concepts, and every sentence carries a concrete filing rule, fitting the 'every token earns its place' anchor.	5 / 5
Actionability	It gives concrete, executable guidance — seven named directories with one-line jobs, a two-question filing test, filename examples like '2026-08-12-migration-plan.md', and an archive path-preservation rule — but stops short of an exact manifest schema, leaving a minor gap.	4 / 5
Workflow Clarity	Multi-step processes (filing, dating, archiving, housekeeping) are clearly sequenced with implicit checkpoints such as 'always after a bulk import' and 'a migration deserves a manifest', but there is no explicit validate-then-proceed gate for destructive moves, leaving a minor validation gap.	4 / 5
Progressive Disclosure	The skill is a single self-contained file with no need for external references and is organized into clearly headed sections (structure, filing, dating, naming, archiving, housekeeping, preferences), which per the rubric can score 5 when well-organized.	5 / 5
	Total	18 / 20 Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description with an explicit trigger clause and comprehensive coverage of both actions and sub-tasks. It is slightly limited by the absence of common user-side synonyms and minor overlap risk with general file skills.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete actions ('creating, filing, moving, or archiving files') plus the sub-tasks 'which directory a file belongs in', 'how to date and attribute it', and 'when to archive instead of delete', giving comprehensive coverage of the domain.	5 / 5
Completeness	It opens with an explicit 'Use when...' clause and concretely answers both what (creating/filing/moving/archiving plus dating and attribution) and when, matching the anchor for clear and explicit answers to both.	5 / 5
Trigger Term Quality	Natural trigger terms like 'creating, filing, moving, or archiving files' and 'agent workspace' are present, but common user synonyms such as 'organize', 'clean up', or 'where should I put' are missing, leaving a few natural terms out.	4 / 5
Distinctiveness Conflict Risk	The 'agent workspace' file-organization niche is mostly distinct, but broad file-handling language could overlap with other file-management skills, so it is not fully conflict-free.	4 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: spacedriveapp/spacebot
Path: skills/builtin/workspace-organization/SKILL.md
Commit: ab2c160

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.