CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-decay

Revalidate persistent agent knowledge by classifying why it can become stale and how quickly it changes, then retain, revise, externalize, or retire it. Use when reviewing skills, stored instructions, facts, preferences, assumptions, or workflows; when an owner, decision, or dependency changes; or when self-improvement captures, reviews, or promotes a learning. Works independently of self-improvement. Not for runtime context-window degradation, unsaved task observations, or age-based deletion.

73

Quality

92%

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

The canonical home for this skill is context-decay in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%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-engineered instruction-only skill: a sequenced five-step workflow with genuine validation gates, feedback loops, and approval boundaries, supported by real one-level-deep references. Its weaknesses are repetition of the approval-boundary rules across sections and reliance on judgment language with worked examples fully externalized.

Suggestions

Consolidate the approval-boundary statements (currently repeated in 'Scope and activation', section 5, and 'Skill findings') into one statement plus a single link to references/skill-review.md.

Add one compact inline worked example of a complete claim review (check → outcome → filled contract) in SKILL.md so common cases are covered without opening references/examples.md.

Consider moving the 'Self-improvement handoff' and 'Skill findings from learning and healing' detail to a reference, keeping only the boundary summaries in SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense, rule-first prose with no padding about concepts Claude already knows, but the approval boundary is stated three times ("Skill changes are proposals until the user explicitly approves the scoped changes", "use the approval boundary above", "each originating skill still enforces the approval boundary") and the multi-skill boundary statements repeat across sections. That places it at anchor 4 ("efficient; minor instances... that could be trimmed") rather than anchor 5's "every token earns its place".

4 / 5

Actionability

Concrete decision tables (decay type → revalidation method; outcome → use-when/result), a complete copy-paste-ready YAML contract example, install commands, and a ready-made Copilot prompt. However, the core steps rely on judgment phrasing ("choose the primary decay type", "use the consequence of staleness to choose urgency") and all worked examples are offloaded to references/examples.md rather than any inline end-to-end case, leaving minor gaps versus anchor 5's "specific examples cover the common cases".

4 / 5

Workflow Clarity

A clearly numbered 1–5 sequence (identify → classify → check/outcome → contract → apply/report) with explicit validation checkpoints ("Perform the smallest check that can answer the claim. Record the evidence, scope/version checked, and actual check date"; "leave validation pending and name the missing evidence"), an error-recovery feedback loop ("After editing, reread the affected claims and check their source links and consistency"), and a report checklist ("Report each reviewed claim's type/rate, evidence or gap, disposition... plus next check trigger"). Destructive operations (retire, skill edits) are gated behind explicit approval and unresolved-state handling, matching anchor 5.

5 / 5

Progressive Disclosure

Two references (skill-review.md, examples.md) are real files, one level deep, clearly signaled with purpose ("Read references/skill-review.md for the review and approval workflow"; "For worked examples and review cases, read references/examples.md"), and the split is sensible. But the ~240-line body carries substantial niche rule content (self-improvement handoff details, the skill-findings/healing sections) that could itself live in a reference, leaving it at anchor 4's "minor organization gaps" rather than a lean overview at anchor 5.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: concrete actions, explicit what/when with natural trigger phrases, and explicit non-goals that de-conflict it from adjacent skills. Every dimension lands on its top anchor without verbosity or padding.

DimensionReasoningScore

Specificity

Names multiple concrete actions — "Revalidate persistent agent knowledge by classifying why it can become stale and how quickly it changes, then retain, revise, externalize, or retire it" — covering the full outcome space (classify, revalidate, retain, revise, externalize, retire). This matches the anchor "Lists multiple specific concrete actions; comprehensive coverage"; anchor 4 would require a coverage gap, and none is evident in the core workflow.

5 / 5

Completeness

Both questions are explicitly answered: what ("Revalidate... by classifying why... then retain, revise, externalize, or retire") and when ("Use when reviewing skills... when an owner, decision, or dependency changes; or when self-improvement captures, reviews, or promotes a learning"). Concrete trigger phrases are present, matching the anchor-5 example structure exactly; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases span six context types ("skills, stored instructions, facts, preferences, assumptions, or workflows"), three change events ("an owner, decision, or dependency changes"), and the self-improvement lifecycle, plus explicit exclusions ("Not for runtime context-window degradation, unsaved task observations, or age-based deletion"). Coverage including synonyms is comprehensive, matching anchor 5 rather than the "a few natural terms missing" of anchor 4.

5 / 5

Distinctiveness Conflict Risk

A clear niche (staleness of persistent knowledge) with explicit boundary statements against neighboring skills: "Works independently of self-improvement. Not for runtime context-window degradation, unsaved task observations, or age-based deletion." This is more distinct than anchor 4's "minor overlap risk with closely related skills" — the main conflicts (self-improvement, context-surfing, self-healing) are pre-empted.

5 / 5

Total

20

/

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

pskoett/pskoett-ai-skills

Path

agent-plugin/skills/context-decay/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.