CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-orchestration-improve-agent

Systematic improvement of existing agents through performance analysis, prompt engineering, and continuous iteration.

62

1.24x
Quality

57%

Does it follow best practices?

Impact

81%

1.24x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/agent-orchestration-improve-agent/SKILL.md

The canonical home for this skill is agent-orchestration-improve-agent in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

48%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 skill lays out a genuinely well-sequenced optimization lifecycle with strong validation and rollback gating, but most of its bulk is generic prompt-engineering and testing textbook content rather than executable, skill-specific procedure, and it is a monolithic file with no progressive disclosure. Trimming known-concept sections and splitting reference material into bundled files would substantially raise token efficiency and navigability.

Suggestions

Cut or drastically compress the sections that restate knowledge Claude already has (2.1 Chain-of-Thought, 2.2 few-shot best practices, 2.3 role definition, statistical-significance basics, MAJOR/MINOR/PATCH semantics), keeping only the skill-specific procedure for applying them.

Replace placeholder templates ('[X%]', 'Use: context-manager / Command: analyze-agent-performance $ARGUMENTS') with concrete, executable commands or scripts — e.g., an actual analysis script in scripts/ and real commands in the body — or remove invocations of tools that do not exist in the bundle.

Split detailed reference material (evaluation metrics catalog, rollout/rollback procedures, example structures) into bundled reference files linked one level deep from a concise SKILL.md overview, implementing progressive disclosure.

DimensionReasoningScore

Conciseness

The ~340-line body spends large sections restating knowledge Claude already has: Chain-of-Thought prompt patterns ('Let's approach this step-by-step...'), few-shot best practices (select diverse examples, order simple to complex), role-definition elements, versioning semantics (MAJOR/MINOR/PATCH), and statistics basics (95% confidence, Cohen's d, power analysis). The '[Extended thinking: ...]' block at the top is also pure padding. This is 'noticeably verbose; several unnecessary explanations or padded sections' — not level 1, since it avoids conversational filler and concept tutorials, and the phase structure is genuinely information-dense.

2 / 5

Actionability

Some concrete guidance exists (a baseline report template, an example structure for good/bad cases, version naming format, rollback trigger thresholds, staged rollout percentages), but the operational commands are pseudocode-style invocations of undefined tools ('Use: context-manager / Command: analyze-agent-performance $ARGUMENTS --days 30', 'Use: prompt-engineer / Technique: chain-of-thought-optimization') with no real scripts or files behind them, and templates use unfilled placeholders ([X%], [User request]). This matches 'some concrete guidance but incomplete; pseudocode instead of executable code' rather than level 4's 'concrete code or commands with minor gaps'.

3 / 5

Workflow Clarity

The process is clearly sequenced (baseline analysis → prompt improvements → testing/validation → versioned staged rollout) with explicit validation checkpoints: statistical significance requirements for A/B tests, quantified rollback triggers ('Success rate drops >10% from baseline'), a 5-step rollback loop with re-testing before retry, and success criteria that gate full deployment. It falls short of level 5 because many steps within phases are descriptive checklists rather than instructed actions with explicit 'verify before proceeding' checkpoints, and per-phase validation of the improvements themselves is left implicit.

4 / 5

Progressive Disclosure

The body has clear section headers and a logical phase structure, but it is a monolithic ~340-line file with no bundle files (references/, scripts/, assets/ are all absent) and no pointers to external material. Content that clearly belongs in separate reference files — the full evaluation-metrics catalog, rollout/rollback procedures, and example structures — is inlined in SKILL.md, matching the level-3 anchor 'some structure but could be better organized; content that should be separate is inline'. It is above level 2 because organization and headers are present, but below level 4 because nothing is split out or referenced.

3 / 5

Total

12

/

20

Passed

Description

50%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 accurate but generic: it states a clear 'what' at a high level while providing no 'when to use' guidance and few natural trigger terms. It would benefit from an explicit 'Use when...' clause and more concrete, distinctive capability language drawn from the skill's actual scope.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to improve, optimize, or debug an existing agent's performance, run A/B tests on prompts, or iterate on agent behavior.'

List more of the skill's concrete capabilities in the description (failure-mode analysis, A/B testing with statistical significance, staged rollout and rollback) instead of the abstract trio 'performance analysis, prompt engineering, and continuous iteration'.

Include natural user phrasings and synonyms such as 'optimize', 'tune', 'evaluate', or 'agent isn't working well' to improve trigger-term coverage and distinctiveness from generic prompt-engineering skills.

DimensionReasoningScore

Specificity

The description names the domain ("existing agents") and lists three actions ("performance analysis, prompt engineering, and continuous iteration"), but these are high-level labels rather than concrete operations. It omits major capabilities the skill actually covers (A/B testing, failure-mode classification, staged rollout and rollback), so coverage is not comprehensive — matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor better than the level-4 'several specific actions with minor gaps' anchor.

3 / 5

Completeness

The 'what' is stated clearly (systematic improvement of existing agents via analysis, prompt engineering, iteration), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. It is not level 2 because the 'what' is concrete rather than vague.

3 / 5

Trigger Term Quality

Some relevant keywords are present ("agent", "performance", "prompt engineering", "improvement"), but common natural phrasings users would actually say are missing: "optimize", "tune", "evaluate", "debug my agent", "A/B test", "iterate on prompts". This fits the level-3 anchor 'some relevant keywords but missing common variations or synonyms' rather than level 4, which requires good keyword coverage.

3 / 5

Distinctiveness Conflict Risk

"Improvement of existing agents through performance analysis, prompt engineering" carves out a niche (optimization vs. creation), but it overlaps with generic prompt-engineering, agent-evaluation, and testing skills, matching the level-3 anchor 'somewhat specific but could still overlap with similar skills'. It does not reach level 4 because the phrasing gives no trigger that would clearly disambiguate it from a pure prompt-engineering skill.

3 / 5

Total

12

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/agent-orchestration-improve-agent/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.