CtrlK
BlogDocsLog inGet started
Tessl Logo

update-knowledge-base

Cross-reference recently shipped tickets against your help center and changelog to detect outdated articles, missing documentation, and undocumented features. Suggests updates and writes draft copy where possible. Use after each release or on a weekly cadence.

65

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An actionable, well-organized skill body with a clear 5-step template and copy-ready placeholders. The two gaps are a missing verification checkpoint for a batch operation and minor intro redundancy with the description.

Suggestions

Add an explicit validation step before Save (e.g. re-read each suggested update against the source ticket to confirm the 'now vs. docs say' delta is accurate) to satisfy the batch-operation feedback-loop expectation.

Trim the opening prose so the body starts at the Prompt Template, avoiding restating the description's purpose.

DimensionReasoningScore

Conciseness

The body is mostly lean — a structured template, compact setup table, and brief tips with no concept explanations — but the intro paragraph ('Every release creates documentation debt...') restates the description's purpose, adding light redundancy that could be trimmed.

2 / 3

Actionability

Provides a concrete 5-step template with per-step instructions, named placeholders and example values, a fixed output filename pattern, a specific output path, and a structured gap-reporting format — copy-paste ready guidance for an instruction-only skill.

3 / 3

Workflow Clarity

The five steps are clearly sequenced, but this batch documentation operation has no validation or verification checkpoint — Step 5 simply saves without confirming the suggestions or drafts are accurate — which caps clarity at 2 per the batch-operations guideline.

2 / 3

Progressive Disclosure

A single, well-organized file with clear sections (Prompt Template, Setup, Placeholders, Tips) and no nested or external references; with no bundle files present, the well-structured single-file layout meets the bar for full credit.

3 / 3

Total

10

/

12

Passed

Description

85%

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, specific description that names concrete actions and an explicit when-clause in third person. Its only weakness is trigger-term coverage: the natural user phrases are parked in suggest_while the description itself relies on cadence language.

Suggestions

Move one or two natural user phrases (e.g. 'when docs are out of date' or 'update the knowledge base') into the description itself so trigger keywords appear in the field being evaluated.

Consider adding 'keep the help center in sync' phrasing to the description to broaden natural trigger coverage beyond cadence-only terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Cross-reference recently shipped tickets against your help center and changelog', 'detect outdated articles, missing documentation, and undocumented features', 'Suggests updates and writes draft copy' — matching the comprehensive-actions anchor.

3 / 3

Completeness

Clearly answers what (cross-reference, detect gaps, suggest updates, write draft copy) and gives an explicit when clause ('Use after each release or on a weekly cadence'), satisfying both halves rather than leaving when implied.

3 / 3

Trigger Term Quality

The description's only trigger phrasing is 'Use after each release or on a weekly cadence', which names a cadence rather than the natural terms users say (e.g. 'docs out of date', 'update help center'); the natural keywords live in the separate suggest_when field, not the description, so coverage is partial.

2 / 3

Distinctiveness Conflict Risk

The niche — reconciling shipped tickets against help center and changelog to find doc debt — is distinct with triggers unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

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.

Validation15 / 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
amplitude/builder-skills
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.