CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

creating-process-files

Creates process files - text as code instructions for reliable AI workflows. Use when creating new process files.

Quality

73%

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/creating-process-files/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 compact, well-structured instruction skill with a clear four-phase workflow and mostly concrete guidance. Its main weaknesses are the redundant Steps/Phases sections and an implicit clarify-to-revise loop, which hold it just short of excellent.

Suggestions

Delete the "Steps" section (or fold it into "Phases" as one-line summaries) — it duplicates the four phase descriptions verbatim in purpose.

Make the Phase 3 → revision loop explicit: state that clarifying answers are applied to the draft before Phase 4 simplification, rather than having Phase 4 review the Phase 2 draft.

Specify the expected formats for the template pieces (e.g., that [HEADER] is a markdown H1 and where STARTER_CHARACTER appears in output) so the draft phase needs no guesswork.

DimensionReasoningScore

Conciseness

The body is lean and defines only project-specific concepts (process files, STARTER_CHARACTER) without explaining things Claude already knows. However, the "Steps" section is a four-bullet summary that fully duplicates the later "Phases" section, and the "Description" section repeats the frontmatter — real trimming opportunities that keep it below anchor 5's "every token earns its place".

4 / 5

Actionability

As an instruction-only skill it gives concrete, executable guidance: six numbered interview steps with specifics ("Suggest 5-8 appropriate emoji"), a defined template in "Pieces", and a crisp interview protocol ("Ask one question at a time"). Minor gaps remain — e.g., the format of [HEADER] and [FILE_NAME] is never specified — so it stops short of anchor 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

The four phases are clearly sequenced and include human-in-the-loop checkpoints ("Ask to review it", the Phase 3 inconsistency check). But there is no explicit loop connecting Phase 3's clarifying questions back to a revision of the draft — Phase 4 reviews "the process file created in phase 2" as if Phase 3 findings were never applied — which keeps it below anchor 5's explicit feedback loops.

4 / 5

Progressive Disclosure

The skill is self-contained with no bundle files and no dangling references (the Examples section cleverly self-references this file), and sections are clearly headed and easy to navigate. The Steps/Phases duplication is a minor organization gap — two places describe the same phases — so it does not fully meet anchor 5's pristine organization for a self-contained skill.

4 / 5

Total

16

/

20

Passed

Description

58%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 short, third-person, and structurally complete (what + an explicit Use-when clause), but it is thin: one action, one circular trigger phrase, and no synonyms. It is serviceable but would rarely fire from a user's natural phrasing unless they already knew the term "process file".

Suggestions

Mention the full capability set — the body says the skill also "fine tune[s] existing ones", but the description only says "Creates", which understates specificity and completeness.

Replace the circular when-clause with concrete trigger contexts, e.g. "Use when creating or refining process files, step-by-step AI instruction templates, or structured workflow definitions."

Add natural synonyms or related terms users might say (workflow file, SOP, instruction template) to improve trigger term quality and reduce reliance on the coined term "process files".

DimensionReasoningScore

Specificity

"Creates process files" is a single concrete action, and "text as code instructions for reliable AI workflows" defines the domain but adds no further actions. This sits between anchor 2 ("Names the domain but actions are minimal or generic") and anchor 4 ("Lists several specific actions") — one action plus a definition is not 'several actions', so it lands on 3.

3 / 5

Completeness

Both parts are explicitly stated: the "what" ("Creates process files - text as code instructions...") and an explicit "Use when..." clause, so the missing-trigger cap at 3 does not apply. However, the when-clause is circular — it restates the action rather than giving concrete trigger contexts — so it does not reach anchor 5.

4 / 5

Trigger Term Quality

The only trigger phrase is "Use when creating new process files" — relevant but with no synonyms or natural variations (e.g., workflow templates, step-by-step instructions, SOPs). Not anchor 2's generic "Works with files", but well short of anchor 4's "good keyword coverage".

3 / 5

Distinctiveness Conflict Risk

"Process files" is a niche term, but it is ambiguous (it can read as the verb phrase 'process these files') and the concept overlaps with generic workflow/prompt/instruction-authoring skills. Anchor 4's "mostly distinct, minor overlap risk" is not fully met, while anchor 3's "somewhat specific but could still overlap with similar skills" fits.

3 / 5

Total

13

/

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

saski/arnesto

Path

.agents/skills/creating-process-files/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.