CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agently-stage

Use for Agently-Stage process-local task lifetime and sync/async interop: Stage scopes and handles, settlement/cancellation, StageCallBridge and StageStream, Tunnel replay channels, or local EventEmitter listeners. Choose this even inside TriggerFlow when a provider-owned sync wrapper bridges an async SDK; use TriggerFlow for application workflow orchestration or persistence.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

78%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, lean overview skill with excellent progressive disclosure and concrete API-level selection guidance. The main costs are the lengthy version-check preamble and the absence of small executable code examples for the most common bridging patterns.

Suggestions

Trim the 19-line version-check section to its operative rules (one fetch, compare hashes, ask once on mismatch, skip silently otherwise) — the enumerated prohibitions could be compressed to a single sentence.

Add one short copy-paste snippet each for the two most common patterns (e.g., Stage.as_sync on an async callable, and Stage.go(...) + StageHandle.get() across threads) to lift actionability.

Move the version requirement ("Agently 4.1.4.7+ requires agently-stage>=0.3.8,<0.4.0") into a compatibility note at the end or into task-lifecycle.md so time-sensitive pinning does not sit in the main flow.

DimensionReasoningScore

Conciseness

The Boundary, Invariants, and Read-by-Need sections are lean and assume competence, but the 19-line "First use: read-only version check" block is detailed defensive procedural text that could be tightened (e.g., "Never install a checker, write a check cache, schedule work, obtain credentials or request extra permissions for this check"). Not 3 because there is no over-explanation of concepts Claude already knows — the verbosity is confined to one meta-maintenance section; not 5 because that section and the inline version pin ("Agently 4.1.4.7+ requires agently-stage>=0.3.8,<0.4.0") could be trimmed or relocated.

4 / 5

Actionability

Concrete method-level guidance throughout — "Stage.as_sync/as_async for one scalar adapter", "Stage.go(...) plus StageHandle", "get()/async_get()", "wait_settled()/async_wait_settled()" — with a decision list mapping each caller situation to a specific API. Not 5 because there are no copy-paste-ready code snippets for the common bridging cases; not 3 because the selection rules are specific and executable for an instruction-only skill.

4 / 5

Workflow Clarity

The Boundary section gives a clear prioritized selection sequence ("Choose the smallest surface that matches the caller") and the version-check block has explicit failure handling ("if unavailable or malformed, skip"; "On a difference, briefly ask once"), and the invariants act as usage checkpoints. Not 5 because the main usage flow lacks an explicit validate-then-proceed pattern tying selection to the invariant checks; not 3 because the decision sequence is unambiguous and no destructive/batch operations require validation loops.

4 / 5

Progressive Disclosure

A concise overview body with a "Read by Need" section that clearly signals three topic-labeled, one-level-deep references (task-lifecycle.md, bridges-streams-events.md, performance.md), all of which exist in the bundle, plus named cross-referrals to sibling skills. Not 4 because navigation is fully clear and content is appropriately split with no inlined bulk detail.

5 / 5

Total

17

/

20

Passed

Description

92%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 highly specific, well-disambiguated description with an explicit "Use for" trigger clause and concrete capability enumeration. The only weakness is that a few natural phrasings users might say (e.g., blocking on async code) are not covered as synonyms.

DimensionReasoningScore

Specificity

Enumerates multiple concrete capabilities — "Stage scopes and handles, settlement/cancellation, StageCallBridge and StageStream, Tunnel replay channels, or local EventEmitter listeners" — giving comprehensive coverage of the skill's surface. Not below 4 because there are no meaningful gaps; the list spans lifetime, interop, replay, and listeners.

5 / 5

Completeness

Explicitly answers both: what ("process-local task lifetime and sync/async interop" with a concrete capability list) and when ("Use for..." plus "Choose this even inside TriggerFlow when a provider-owned sync wrapper bridges an async SDK"). Not 4 because the when-clause is explicit and concrete rather than merely present.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "task lifetime", "sync/async interop", "settlement/cancellation", "sync wrapper bridges an async SDK", "listeners" — phrasings a developer would actually say. Not 5 because common synonyms like "block on async code" or "convert async to sync" are absent; not 3 because the terms present are natural, not just technical jargon.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Agently-Stage process-local mechanics) with explicit disambiguation — "use TriggerFlow for application workflow orchestration or persistence" — minimizing wrong-skill triggering. Not 4 because the overlap risk with the closest sibling skill is directly addressed in the description itself.

5 / 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

AgentEra/Agently-Skills

Path

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