All skills
tejasshukla2007 avatar

/context-retention-audit

@d5faee4

Audits whether citation visitors can quickly confirm quoted facts by checking bottom-line-first paragraphs and fragment-based deep links. Use when evaluating on-site engagement and context retention after an AI-generated citation.

  • 3 files
  • 6.9 KB
  • Updated 3 weeks ago
  • GitHub

Use this Skill: https://skilld.dev/gh/tejasshukla2007/brand-ai-readiness-audit/context-retention-audit

This session only. Nothing lands on disk.

SKILL.md

≈64 tokens always: the name and description. ≈378 when used: this file. ≈183 more on demand in 1 file.

Context Retention / Scent Trail Audit

When to Use

Use this skill during an engagement audit when a visitor is expected to arrive from an AI-generated citation with a specific fact in mind.

Inputs

  • html_content: The raw HTML document already fetched for the audit.
  • url: Target webpage URL, used by the calling orchestrator for audit context.

Procedure

  1. Pass the already-fetched HTML to scripts/check_anchors.py through standard input.
  2. The script uses its own single-pass ContextRetentionParser; it does not fetch the URL or build a second DOM tree.
  3. Check for a substantive paragraph before the first <h2> and for fragment targets or in-page fragment links.
  4. Emit the script output unchanged.

Deterministic Grading Rubric

You must assign severities and generate findings strictly according to this matrix based on the JSON output from check_anchors.py.

Condition from Script Output Finding ID Finding Title Severity Priority
No 15-120 word paragraph appears before the first <h2> CTX-001 Missing Bottom-Line-First Paragraph medium medium
No in-page fragment links (href="#...") or section targets (id attributes on headings/sections) detected CTX-002 Missing Fragment Navigation for Deep Linking medium medium

Allowed Tools

  • bash (executing bundled script scripts/check_anchors.py)

Output

Emit only a valid JSON array conforming to the references/finding_schema.json format.

Source: SKILL.md on GitHub

No third-party reports yet.

Signed by skilld at d5faee4. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 3 weeks ago

README badge

README badge for tejasshukla2007/brand-ai-readiness-audit/context-retention-audit