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

88%

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

The canonical home for this skill is manage-file-operations in NyssaAI/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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-structured, safety-first workflow skill: clear sequencing, explicit validation and rollback gates, and disciplined delegation to one-level-deep references. The main defects are a dangling core.md reference and two orphaned bundle files, plus mild cross-section repetition.

Suggestions

Add the missing core.md (the 'file-management foundation') to the bundle, or remove/repoint the dangling link in the body's opening paragraph.

Reference document-maturity.md and intermediate-work.md from the body where their guidance applies (e.g., in sections 3 or 4), or remove them from the bundle so every reference file is discoverable.

Consolidate the repeated recovery/reporting caveats in sections 3, 4, and 5 into a single statement to trim the remaining redundancy.

DimensionReasoningScore

Conciseness

The body is dense, operative prose with no re-teaching of concepts Claude already knows, and detail is delegated to references rather than inlined. It falls at the 4 anchor only because of minor repetition across sections 3-5 (preserve-recovery and 'do not claim completion' phrasing recurs) that could be tightened.

4 / 5

Actionability

Concrete decision rules are given ('A copy or import retains its source', 'do not edit the source to make the copy work', 'Before removing a remaining working source... verify the destination and affected references') with conditional pointers to the exact reference sections for specifics. It is not a 5 because some directives remain policy-level (e.g., 'Keep recoverable history for substantive revisions') without specifying what form that history takes.

4 / 5

Workflow Clarity

Five clearly sequenced stages (establish, inspect, perform, verify, report) with a dedicated verification section, an explicit error-recovery loop ('If content diverges or verification fails, preserve recoverable copies and report the unresolved difference'), and a closing checklist. This satisfies the destructive/batch validation requirement and matches the 5 anchor's checklists and feedback loops.

5 / 5

Progressive Disclosure

The body is a lean overview with well-signaled, conditional one-level-deep references ('For an import, copy, occupied destination, or uncertain identity, read identity and collisions'), and referenced files with valid heading anchors exist. It misses the 5 anchor because the linked 'file-management foundation' (core.md) is missing from the bundle and two existing reference files (document-maturity.md, intermediate-work.md) are never referenced from the body.

4 / 5

Total

17

/

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: concrete capability list, natural explicit triggers, and an explicit do-not-use boundary against sibling skills. The only gap is slightly thin synonym coverage in trigger terms (one natural phrase per operation).

DimensionReasoningScore

Specificity

The description lists six concrete operations ("safely move files", "rename folder", "copy directory", "archive files", "resolve destination collision", "resume interrupted file operation") plus reference repair and non-destructive moves, matching the 5 anchor's comprehensive concrete-action coverage rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

It explicitly answers 'what' ("Covers safe filesystem operations, reference repair, and non-destructive moves") and 'when' ("Use this skill when the user asks to..." with six concrete trigger phrases), which matches the 5 anchor rather than the 4 anchor where the 'when' could be more explicit.

5 / 5

Trigger Term Quality

Trigger phrases are natural user phrasings covering each operation type, fitting the 4 anchor's 'good keyword coverage; a few natural terms missing'. It is not 5 because it gives one term per operation and omits common synonyms and variations like 'back up', 'transfer', 'import', or 'restore'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (collision- and recovery-aware filesystem operations) with distinct triggers, reinforced by an explicit negative boundary ("Do NOT use this skill for PARA vault classification (use `para-vault`) or drafting text (use `write-like-me`)") that actively disambiguates sibling skills — minimal conflict risk.

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

.agents/plugins/agent-skills/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.