CtrlK
BlogDocsLog inGet started
Tessl Logo

host-file-editing

Guide safe use of text_editor_remote for reading, writing, and patching files on the connected A0 CLI host. Use when the user asks to inspect or edit files on their computer, local files, CLI host files, or files that are explicitly not Docker/server files.

75

Quality

94%

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

93%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 is a lean, dense instruction sheet: unambiguous operation-selection rules, exact patch_text syntax, hard size limits, and a failure-handling section with a stale-edit retry loop. The single weakness is workflow validation — destructive host writes lack a proactive post-edit verification step, relying instead on the tool's freshness rejection.

Suggestions

Add a post-edit verification step to the Editing Flow, e.g. 'After a write or patch, reread the affected lines to confirm the change landed as intended' — this would give the destructive write path a proactive feedback loop.

State what happens when multiple patch_text hunks in one request partially succeed (all-or-nothing vs. partial application), so failure recovery is unambiguous for multi-hunk edits.

Add one tiny worked patch_text example (2-3 lines showing @@ anchor, -old, +new) to make the hunk syntax rules instantly executable without re-deriving them from the rules list.

DimensionReasoningScore

Conciseness

The body is ~45 lines of lean imperative bullets with zero padding — no explanation of what files or patching are, no throat-clearing, just operational rules like "Treat reads as bounded text previews (2,000 lines / 256 KiB)" and "Every non-header content line must begin with exactly one prefix". Every token earns its place and the skill assumes Claude's competence throughout.

5 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: concrete operation selection ("Prefer patch with old_text and new_text for simple exact replacements", "Use patch_text for context-anchored edits"), exact hunk syntax with @@ anchors and +/- prefixes, hard numeric limits (2,000 lines / 256 KiB), and concrete failure responses (F3 for blocked writes, reread-and-retry on stale rejection). The scoring notes state code absence is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The Editing Flow section gives a clear decision sequence (read first, then choose write/patch/patch_text by case) and includes an explicit feedback loop ("If freshness-aware line patching rejects an edit as stale, reread the file and retry with updated ranges") plus a dedicated Failure Handling section. It falls short of 5 because host file writes are destructive yet there is no post-write verification step (e.g., reread to confirm the edit landed) — validation is reactive to tool rejection rather than proactive — keeping it at 'most checkpoints present'.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no bundle files, and needs none: content is split into five clearly-scoped sections (Boundary, Access Modes, Editing Flow, Patch Text Rules, Failure Handling) that are each concise enough to belong inline. Per the rubric guideline, a sub-50-line skill with no need for external references scores 5 with well-organized sections, which this matches.

5 / 5

Total

19

/

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.

The description is a strong example: it names the exact tool, enumerates its concrete operations, states an explicit 'Use when' clause with natural trigger phrases, and positively distinguishes CLI-host files from Docker/server files. The only minor gap is synonym coverage in the trigger terms.

DimensionReasoningScore

Specificity

"Guide safe use of text_editor_remote for reading, writing, and patching files on the connected A0 CLI host" names the exact tool and its three concrete operations, which comprehensively covers the tool's capability surface (reads are previews, writes replace, patches edit). It is not score 4 because no operation category is missing; the read/write/patch triple is complete for a text-editor tool.

5 / 5

Completeness

It explicitly answers 'what' (guide safe use of text_editor_remote for reading, writing, and patching host files) with a clear 'Use when the user asks to inspect or edit files on their computer, local files, CLI host files...' trigger clause with concrete trigger phrases. Both halves are explicit and concrete, matching the 5 anchor exactly; it is not 4 because the 'when' clause is fully specific, not merely adequate.

5 / 5

Trigger Term Quality

"inspect or edit files", "files on their computer", "local files", "CLI host files", "not Docker/server files" give good natural-phrase coverage matching how users would phrase host-file requests. It falls short of 5 because synonyms like "open", "modify", "my machine", or "on this computer" variants are absent, though it is well above the 3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The tool name, the host-vs-Docker/server boundary, and the negative trigger ("files that are explicitly not Docker/server files") carve out a clear niche with minimal conflict risk against other file skills. It is not 4 because the boundary is stated positively and negatively, leaving almost no overlap with similar skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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
agent0ai/agent-zero
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.