CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ipollowork-design-editorial

Create or edit articles and reports in the current iPolloWork Design session.

54

Quality

68%

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 ./.agents/skills/ipollowork-design-editorial/SKILL.md

The canonical home for this skill is ipollowork-design-editorial in Devin-AXIS/iPolloWork

SKILL.md
Quality
Evals
Security

Quality

Content

68%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 maximally lean routing layer: excellent token efficiency and well-scoped, conditionally-read references, but it reads as a constraint checklist rather than an executable workflow. The actual editing procedures, step order, and validation details are all delegated to external files in another skill's bundle.

Suggestions

Add a brief explicit step sequence for the edit workflow (route → read injected source → resolve selection → edit → verify → disclose), so the order is not merely implied by paragraph position.

Turn telegraphic constraints into directive instructions — e.g., expand "A stale locator requires a new selection before editing" into what to do (re-run selection, then proceed) — since no local file supplies the missing detail.

Add section headers (Routing / Reading scope / Editing constraints / Verification) to aid navigation, and note or vendor the cross-skill references so the skill does not depend on "../ipollowork-design-studio/" resolving.

DimensionReasoningScore

Conciseness

The body is extremely lean with zero padding and no explanation of concepts Claude already knows — every sentence (e.g., "The host owns preview/export; no replacement project, preview host or application-source edits") carries an instruction. It fully assumes Claude's competence; every token earns its place.

5 / 5

Actionability

There is concrete guidance — specific paths ("design/<session-id>/", "design-tokens.css"), concrete constraints ("Preserve `--ipw-*` tokens/variable bindings, component IDs"), and per-type routing to named rule files — but no executable steps for the core editing task itself; the actual procedures are deferred to external files. This matches 'some concrete guidance but incomplete; missing key details' rather than the mostly-executable anchor at 4.

3 / 5

Workflow Clarity

Checkpoints exist ("Verify affected editing/interaction and requested supported exports; disclose unavailable/unperformed checks", "Shared style/token changes require whole-artifact rechecking", stale-locator recovery), so validation is not absent. But the sequence (route → read source → select → edit → verify → report) is only implicit in paragraph order with no explicit ordering, matching 'steps present but checkpoints implicit / sequence gaps'.

3 / 5

Progressive Disclosure

The body is a short overview with well-signaled, one-level-deep references ([Article rules], [Report rules], [Shared guidance], [Other rules]) plus scoped reading instructions ("Targeted copy/selection/theme edits read affected type sections only; skip catalogs"), which is good structure. However, the skill has no local bundle files and all four references live in a sibling skill directory ("../ipollowork-design-studio/references/"), which is fragile and unverifiable from this bundle, and the body has no section headers — matching 'good structure; minor organization gaps' rather than the fully clean anchor at 5.

4 / 5

Total

15

/

20

Passed

Description

53%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 states a clear, appropriately scoped capability in third person, but it is a single clause with no 'Use when...' trigger guidance and thin keyword coverage. Adding an explicit trigger clause and a few natural synonyms would lift the completeness and trigger dimensions substantially.

Suggestions

Add an explicit trigger clause, e.g., "Use when working in an iPolloWork Design session on manifest category `article` or `report`, or when the user asks to create, edit, or update articles or reports."

Broaden natural trigger terms with synonyms users would actually say ("write", "draft", "publish", "copy-edit", "report content").

Enumerate one or two more concrete actions (e.g., targeted copy/theme edits, asset updates) to strengthen specificity.

DimensionReasoningScore

Specificity

"Create or edit articles and reports in the current iPolloWork Design session" names the domain and exactly two concrete actions (create, edit), matching the anchor for 1-2 concrete actions. It does not list several specific actions (e.g., copy edits, theme changes, asset work), so it does not reach 4.

3 / 5

Completeness

The 'what' is clear (create or edit articles and reports), but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'in the current iPolloWork Design session' only weakly implies when. Per the rubric, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural nouns like "articles", "reports", "create", and "edit" are present, but common variations users would say (write, draft, blog post, document, copy-edit, publish) are absent. This fits 'some relevant keywords but missing common variations or synonyms' rather than the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

"articles and reports in the current iPolloWork Design session" carves out a clear product-specific niche with minimal conflict risk, but without explicit trigger phrases it could still be picked up by general writing/document skills — mostly distinct with minor overlap, matching anchor 4 rather than the distinct-trigger clarity of 5.

4 / 5

Total

13

/

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: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

Devin-AXIS/iPolloWork

Path

.agents/skills/ipollowork-design-editorial/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.