CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agently-collaboration

Use for coding-agent conversation communication across any project or task: explain the current task and outcome, report progress, maintain the complete plan, present decisions or blockers, and resume or hand off long work. Applies alongside coding, design, research and writing skills without requiring Agently. Brief factual answers stay brief; application runtime progress and deliverable design remain with their task owners.

Quality

76%

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 ./skills/agently-collaboration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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.

A well-structured instruction-only skill with genuinely novel, specific policy (glossary caps, version-check protocol, taskboard rules) and correctly organized one-level references. Its main weaknesses are density and abstraction: heavily qualified multi-clause sentences throughout, and core reporting principles conveyed without any inline example, leaving the reader to synthesize the intended output shape from references.

Suggestions

Move the version-check protocol details into a reference file (like the other supplemental material) and keep a 2-3 line summary in SKILL.md, so the body opens with the skill's actual purpose.

Include one compact example of a well-formed progress report or taskboard inline in the main body, so the abstract top-down/reader-order principles have a concrete anchor without opening references.

Split the longest multi-clause sentences (e.g. the version-check and glossary-limit rules) into shorter single-rule statements; several currently require re-reading to parse the conditions.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and nearly every sentence encodes a rule, but at ~195 lines of dense prose much of it could be tightened — e.g. the 19-line version-check section piles up edge cases ('Equal means the recorded source matches, not that local supplements are absent') and many sentences carry three or four qualifying clauses that force re-reading.

3 / 5

Actionability

Some guidance is concretely parameterized ('make at most one anonymous GET', '6 s / 64 KB', glossary '10 terms or fewer... hard maximum of 15'), but the core communication guidance is abstract principle ('Organize the rest top-down: a clear main point, logically grouped supporting ideas', 'Plan what the reader needs to know at each point') with no in-body example of a well-formed report — examples are deferred to a reference file.

3 / 5

Workflow Clarity

The prescribed process is clearly sectioned (version check → lead with task/main point → reader order → language → taskboard → qualifications → 'Before sending, check that a reader... can understand... from this message alone') and the version check has explicit failure handling ('skip without retry or blocking the task'), but the final self-check lacks a concrete recovery loop and the principles sections are ordered more by topic than by an explicit execution sequence.

4 / 5

Progressive Disclosure

All three bundle files (references/taskboard-and-handoffs.md, references/reporting-examples.md, assets/session-guidance.md) are real, one level deep, and clearly signaled with purpose ('Read [Taskboard and handoffs](references/taskboard-and-handoffs.md) for multi-step work, revisions, recovery or handoff'; read reporting-examples 'only when calibrating style'). Minor gap: the long, peripheral version-check section is inlined at the top of the main body rather than split out, pushing the skill's actual purpose statement below it.

4 / 5

Total

14

/

20

Passed

Description

80%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 in third person that names the domain, lists five concrete capabilities, and includes an explicit 'Use for...' trigger clause plus boundary clarifications against adjacent skills. The 'when' is present but broad — concrete user-sayable trigger phrases would lift completeness and trigger-term coverage to the top anchor.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions with comprehensive coverage of the skill's scope: 'explain the current task and outcome, report progress, maintain the complete plan, present decisions or blockers, and resume or hand off long work' — five distinct named capabilities, matching the level of the score-5 anchor rather than the 'several specific actions; minor gaps' of 4.

5 / 5

Completeness

Both what and when are present: the 'what' is explicit (the five listed communication actions), and the trigger is stated as 'Use for coding-agent conversation communication across any project or task... Applies alongside coding, design, research and writing skills'. However, the 'when' is broad and conditional-free rather than concrete trigger phrases (no 'when the user asks for a progress report' style clause), matching anchor 4 ('when' could be more explicit or specific) rather than 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage ('report progress', 'maintain the complete plan', 'present decisions or blockers', 'resume or hand off long work', 'brief factual answers') with a few commonly-said variants missing (e.g. 'status update', 'summarize the work', 'handoff'). This fits 'good keyword coverage; a few natural terms missing' rather than 5's comprehensive synonym coverage, and is well above 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The niche (conversation communication and work preservation, explicitly separated from execution: 'application runtime progress and deliverable design remain with their task owners') is mostly distinct with clear boundary language, but 'conversation communication across any project or task' is broad enough to overlap with general writing/summarization skills, fitting anchor 4 rather than 5's minimal conflict risk.

4 / 5

Total

17

/

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

AgentEra/Agently-Skills

Path

skills/agently-collaboration/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.