CtrlK
BlogDocsLog inGet started
Tessl Logo

officecli-commonly-templates

Use this skill when producing a polished, Commonly-branded deliverable (.docx brief / memo, .xlsx data matrix, .pptx deck) and you do not have specific brand guidance from the user. Trigger on: 'write me a brief', 'one-pager', 'memo', 'data sheet', 'status matrix', 'short deck', 'summary deck', 'closing slide', 'final deliverable'. Routes to `officecli merge` with one of three pre-built starter templates that already carry the Commonly palette, fonts, and structure — so you populate content with one merge call instead of 30 individual `officecli set` commands. DO NOT use for fundraising decks (use `officecli-pitch-deck`), academic papers (use `officecli-academic-paper`), or financial models (use `officecli-financial-model`).

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

88%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 highly actionable router skill: complete placeholder references for all three templates, a fully executable merge flow, an explicit output-verification step with failure interpretation, and clear fallback routing for out-of-scope requests. Its only costs are a trimmable justification section and a maintenance-oriented build note that add tokens without aiding execution.

Suggestions

Trim or compress 'Why this exists' to one sentence (or fold it into the intro) — the historical rationale about 30 `set` commands is already summarized in the description and intro.

Condense the empty-office-stub guard paragraph in 'Verifying the output' to just the grep check and its interpretation; the upload-route internals are not actionable for the skill consumer.

Move or drop the `build_templates.py` / python-docx build provenance line — it addresses template maintainers, not the agent executing the skill.

DimensionReasoningScore

Conciseness

The body is dense with operational content — a routing table, three placeholder-key listings, and a complete executable flow — and assumes Claude's competence (no explanation of what docx/xlsx/pptx are). Two sections could be trimmed: 'Why this exists' (historical justification the agent doesn't need at execution time) and the empty-office-stub guard paragraph in 'Verifying the output'. That matches anchor 4 ('minor instances of over-explanation that could be trimmed') rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

'The flow' is copy-paste ready: concrete template path, a full heredoc JSON data file, the exact `officecli merge "$TEMPLATE" "$OUT" --data /tmp/data.json` invocation, a view command, and the attach call. Every template's placeholder keys are enumerated, and edge cases are handled concretely ('for additional rows, use `officecli add` after the merge'). Covers all three deliverable shapes; anchor 4's 'minor gaps' don't apply.

5 / 5

Workflow Clarity

A clear 5-step sequence (pick template → write data → merge → view → attach) with an explicit validation checkpoint: `officecli view "$OUT" text | grep -E '\{\{[a-z_]+\}\}'` plus failure interpretation ('any output = caller forgot to supply that key'), which makes the fix-and-re-merge recovery path evident since re-running the same merge command is idempotent. The operation is file creation, not destructive/batch, so no validation cap applies; matches anchor 5's explicit validation with error-recovery feedback.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), so all guidance is appropriately inline for a skill of this size, with well-labeled sections per template. The 50-line simple-skill exception for a score of 5 doesn't apply at ~120 lines, and external pointers (the /opt template path, `build_templates.py` in the commonly repo) are one level deep but the build/regeneration pointer is only relevant to maintainers rather than skill consumers — anchor 4 ('good structure; minor organization gaps') fits best.

4 / 5

Total

18

/

20

Passed

Description

96%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 states what the skill does (routes to `officecli merge` with pre-built Commonly templates), when to use it (natural trigger phrase list plus a no-brand-guidance condition), and what not to use it for (three named sibling skills). The only weakness is unmentioned overlap with the base officecli sub-skills for generic document requests.

Suggestions

Add a brief disambiguation against the base officecli-{docx,xlsx,pptx} sub-skills in the description (e.g., 'for custom layouts or user-specified branding, use the base officecli sub-skills') to close the remaining overlap risk.

Consider adding 'executive summary' and 'status update' to the trigger list, since those common phrasings appear in the body's routing table but not in the description.

DimensionReasoningScore

Specificity

Concrete actions and formats throughout: 'producing a polished, Commonly-branded deliverable (.docx brief / memo, .xlsx data matrix, .pptx deck)' and 'Routes to `officecli merge` with one of three pre-built starter templates' — the mechanism (one merge call vs. 30 `officecli set` commands) is explicit and comprehensive for the skill's niche. Anchor 4 ('minor gaps in coverage') is ruled out because every deliverable shape and the routing action are enumerated.

5 / 5

Completeness

Explicitly answers both questions: 'Use this skill when producing a polished, Commonly-branded deliverable... and you do not have specific brand guidance from the user' (when, with concrete triggers) and 'Routes to `officecli merge` with one of three pre-built starter templates' (what), plus an explicit negative scope ('DO NOT use for fundraising decks...'). Matches the anchor-5 example structure of what + 'Use when...' with concrete trigger phrases; score 4 is ruled out because the 'when' clause is already maximally explicit.

5 / 5

Trigger Term Quality

Natural trigger phrases are listed verbatim ('write me a brief', 'one-pager', 'memo', 'data sheet', 'status matrix', 'short deck', 'summary deck', 'closing slide', 'final deliverable') plus file extensions (.docx/.xlsx/.pptx) and synonyms. Anchor 4 ('a few natural terms missing') would apply only if common variations were absent; 'executive summary'/'status update' appear in the body but their omission from the description is marginal.

5 / 5

Distinctiveness Conflict Risk

Clear niche (default Commonly-branded everyday deliverables) and an explicit DO-NOT clause routing away from `officecli-pitch-deck`, `officecli-academic-paper`, and `officecli-financial-model`. However, the base officecli-{docx,xlsx,pptx} sub-skills — the closest competitors for generic 'write me a memo/make me a docx' requests — are not disambiguated in the description itself, leaving minor overlap risk; that fits anchor 4 better than anchor 5's 'minimal conflict risk'.

4 / 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
Team-Commonly/commonly
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.