CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

manage-file-operations

Use this skill when the user asks to "safely move files", "rename folder", "copy directory", "archive files", "resolve destination collision", or "resume interrupted file operation". Covers safe filesystem operations, reference repair, and non-destructive moves. Do NOT use this skill for PARA vault classification (use `para-vault`) or drafting text (use `write-like-me`).

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

62%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.

The body presents a well-sequenced, validation-heavy workflow that is exemplary for destructive file operations, and it appropriately defers detail to reference files. Its weaknesses are repetitive safety prose, policy-level abstraction where concrete verification methods or commands would be actionable, and a reference layer with a broken core.md link and two orphaned bundle files.

Suggestions

Link intermediate-work.md and document-maturity.md from the relevant body sections (or drop them from the bundle) so every bundle file is discoverable from SKILL.md, and fix the core.md link, which does not resolve to any file in the bundle.

Consolidate the unrelated-content/no-deletion constraints, which currently appear in Sections 3, 4, and the verification checklist, into one authoritative statement.

Add concrete verification mechanics (e.g., an actual hash-comparison or diff command, or specific checks for link repair) so the verification steps are executable rather than abstract directives.

DimensionReasoningScore

Conciseness

Mostly efficient prose with no explanations of known concepts, but the same constraints are restated repeatedly: "Never overwrite unrelated content" and "Do not interpret an operation as permission to delete other retained content or reorganize unrelated items" (Section 3) reappear in Section 4 and again in the final checklist, and the top scope callout duplicates the frontmatter's do-not-use clause. It is not a 4 because the repetition goes beyond minor trimming, and not a 2 because there is no padding or background explanation.

3 / 5

Actionability

The body is precise policy but largely abstract: "Inspect the sources, intended destinations, affected references, and existing folder indexes" names what to check without any concrete command or method, and verification is "match expected contents or source hashes" with no executable mechanism. As an instruction-only skill its decision rules (e.g., link-resolution semantics for copies) are specific, but the how of inspecting and verifying is deferred or missing, fitting 'some concrete guidance but incomplete' rather than 'mostly executable'.

3 / 5

Workflow Clarity

A clear five-step sequence (establish, inspect, perform, verify, report) with explicit validation for destructive operations: "Before removing a remaining working source for a move or archive, verify the destination and affected references. If content diverges or verification fails, preserve recoverable copies and report the unresolved difference", plus a closing verification checklist. Not a 4 because no checkpoint is missing — inspect-before-change, rollback path, verify-before-delete, failure handling, and reporting are all explicit.

5 / 5

Progressive Disclosure

References that are linked are well signaled and one level deep ("read [identity and collisions](references/safe-operations.md#identity-and-collisions)", conditional link to naming.md), but the bundle structure has real gaps: the "[file-management foundation](core.md)" link resolves to no file in the bundle, and two of the four bundle references (intermediate-work.md, document-maturity.md) are never mentioned in the body, making half the bundle undiscoverable. It is not a 4 because broken and orphaned references are more than minor organization gaps, and not a 2 because the body itself is appropriately lean with clear signals for the references it does use.

3 / 5

Total

14

/

20

Passed

Description

92%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 description: it pairs an explicit 'Use when...' clause with six quoted natural trigger phrases, a concrete capability summary, and do-not-use delegation to sibling skills. The only weakness is that a few trigger terms lean technical and common synonyms like 'import' or 'duplicate' are absent.

Suggestions

Add more colloquial trigger variants such as 'import', 'duplicate', or 'file already exists' so the quoted phrases match what users naturally say, not just technical framings like 'resolve destination collision'.

DimensionReasoningScore

Specificity

The description lists six concrete quoted operations ("safely move files", "rename folder", "copy directory", "archive files", "resolve destination collision", "resume interrupted file operation") plus "reference repair, and non-destructive moves", giving comprehensive coverage of the skill's actions. It is not a 4 because no meaningful capability gap remains — the dominant operations are all explicitly named.

5 / 5

Completeness

Both halves are explicit: 'when' via "Use this skill when the user asks to..." with concrete trigger phrases, and 'what' via "Covers safe filesystem operations, reference repair, and non-destructive moves" backed by the named operations. This matches the anchor that clearly answers both what and when with concrete trigger phrases, so it is not a 4 (the 'when' is fully explicit, not merely present).

5 / 5

Trigger Term Quality

Good natural-phrase coverage: "safely move files", "rename folder", "copy directory", "archive files" are phrasings users would actually say. Not a 5 because "resolve destination collision" and "resume interrupted file operation" are more technical than natural user speech, and common variants like "import", "duplicate", or "file already exists" are missing.

4 / 5

Distinctiveness Conflict Risk

The explicit negative triggers ("Do NOT use this skill for PARA vault classification (use `para-vault`) or drafting text (use `write-like-me`)") carve out the closest neighboring skills, leaving a clear niche of safe workspace file operations with minimal conflict risk. It is not a 4 because the main overlap risks are explicitly disambiguated.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 4 suspicious

Warning

Total

15

/

16

Passed

Repository

NyssaAI/agent-skills

Path

skills/manage-file-operations/SKILL.md

Reviewed

Table of Contents

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.