CtrlK
BlogDocsLog inGet started
Tessl Logo

office-artifacts

Manage Office files, formats and versions; use Writer, Calc or Impress for content.

53

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/_office/skills/office-artifacts/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 strong, dense operational guide: copy-paste JSON tool calls, an explicit operation/argument reference per format, a sensible read-before-edit workflow with rollback, and well-labeled sections. Weaknesses are minor — a missing presentation example, slight repetition of the Desktop/UI rules, and an inlined arguments block that could be split into a reference file.

DimensionReasoningScore

Conciseness

The body is dense and operational — concrete JSON calls, an operations table, and rules — with almost no explanation of concepts Claude already knows. It is not a 5 because of minor redundancy: the "don't open Desktop automatically" rule appears in both the second paragraph and the Practical Rules ("Never open Editor or Desktop automatically from a tool result"), and the text_editor guidance is likewise stated twice. It is well above 3, which requires 'unnecessary explanation'; here only trimming, not removal of teaching content, is needed.

4 / 5

Actionability

Copy-paste-ready JSON examples cover create, read, replace_text, append_text, set_cells, and create_chart, plus an exact argument-format list ('set_cells accepts { "A1": "value", ... } or [{"sheet":"Sheet1","cell":"A1",...}]'). It falls short of 5 only because the common presentation case has no example — 'slides accepts [{"title":"Slide title","bullets":["point"]}]' is documented as an argument but no set_slides/append_slide call is shown, unlike documents and spreadsheets. It is clearly not a 3, since nothing is pseudocode.

4 / 5

Workflow Clarity

The Workflow section gives a clear sequence (create/open → read before content-sensitive edits → edit → version_history/restore_version), and the read-before-edit rule plus restore_version rollback act as checkpoints, including for risky text replacement ('count limits text replacements'). It is not a 5 because there is no explicit post-edit verification step (no 're-read to confirm the change'), leaving a minor validation gap — though the edit operations here are tool-mediated rather than the fragile unpack/repack pattern, so the destructive-operation cap to 3 does not apply.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so everything must live inline, and the body is well organized into clear sections (Workflow, Minimal Calls, Edit Operations, Practical Rules) with every cross-reference (writer-documents, calc-spreadsheets, impress-presentations) being a pointer to other skills, not dangling files. It is not a 5 because at ~145 lines the ~40-line Edit Operations/Arguments block is genuine API reference detail that a references/ file could carry out of the always-loaded body; it is not a 3 because the structure is clean, navigable, and nothing is buried.

4 / 5

Total

16

/

20

Passed

Description

45%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 correctly identifies its domain and names the LibreOffice applications, but relies on the generic verb "Manage" and completely lacks a "Use when..." trigger clause. Natural user vocabulary (spreadsheet, presentation, docx/xlsx/pptx) is missing in favor of app names, which both weakens triggering and raises conflict risk with the format-specific sibling skills.

Suggestions

State concrete actions instead of "Manage": e.g. "Create, read, and edit Office documents (ODT/DOCX), spreadsheets (ODS/XLSX), and presentations (ODP/PPTX), with version history and rollback."

Add an explicit "Use when..." clause covering natural user phrasing: "Use when the user mentions Office files, Writer, Calc, Impress, or asks for .odt/.ods/.odp/.docx/.xlsx/.pptx files, spreadsheets, or presentations."

Distinguish this skill from the format-specific ones (writer-documents, calc-spreadsheets, impress-presentations), e.g. "Use the format-specific skills for deep Writer/Calc/Impress work; use this skill for general Office artifact management, formats, and versions."

DimensionReasoningScore

Specificity

The description names the domain ("Office files, formats and versions") and the LibreOffice apps ("Writer, Calc or Impress"), but the only action verb is the generic "Manage" — no concrete actions like create, edit, read, or chart are stated. This matches the anchor 'Names the domain but actions are minimal or generic' ('Processes PDF files'). It is not a 3 because there is no second concrete action anywhere in the text, and not a 1 because the domain and app names are explicit rather than purely abstract.

2 / 5

Completeness

The 'what' is present but moderately clear ("Manage Office files, formats and versions") and the 'when' is entirely absent — there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' does name concrete formats/apps rather than being purely vague, and not a 4 because no usage condition is stated or even weakly implied.

3 / 5

Trigger Term Quality

Relevant terms present: "Office files", "Writer", "Calc", "Impress" — but the terms users naturally say ("spreadsheet", "presentation", "docx", "xlsx", "pptx", "odt") are absent; the app names are LibreOffice jargon a casual user would rarely utter. This fits 'Some relevant keywords but missing common variations or synonyms' rather than 4 ('good coverage, a few missing'), since whole categories of natural synonyms are omitted.

3 / 5

Distinctiveness Conflict Risk

"Manage Office files" is somewhat specific to the office domain, but the description's own emphasis on "Writer, Calc or Impress" points directly at the sibling skills the body lists (writer-documents, calc-spreadsheets, impress-presentations), creating real overlap risk with those closely related skills. Fits 'Somewhat specific but could still overlap with similar skills' rather than 4, since the broad 'Office files' scope would plausibly trigger for requests better routed to the format-specific skills.

3 / 5

Total

11

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

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.