CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audit-context-building

Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.

Quality

60%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/audit-context-building/SKILL.md
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's phased structure, checklists, and anti-rationalization table are strong and genuinely actionable for a thinking-process skill, but the body is padded with near-duplicate sections and it references output templates, an example file, a checklist, and an agent that are not bundled — creating a contradiction with its own catalog-scope disclaimer. Consolidating the duplicates and inlining (or actually shipping) the referenced formats would lift it substantially.

Suggestions

Resolve the dangling references: either bundle FUNCTION_MICRO_ANALYSIS_EXAMPLE.md, OUTPUT_REQUIREMENTS.md, and COMPLETENESS_CHECKLIST.md (and the function-analyzer agent), or replace sections 5.3-5.5 with self-contained inline versions of those formats.

Merge the duplicated content — sections 1 and 2 repeat the same 'When active, Claude will' list, and 'Do not use for' duplicates section 9 Non-Goals — to cut a large fraction of tokens.

Move the output format, quality thresholds, and completeness checklist into a single reference file and keep SKILL.md as a lean overview with clearly signaled links.

DimensionReasoningScore

Conciseness

The body is noticeably verbose: sections 1 and 2 repeat the same 'When active, Claude will' bullet list almost verbatim, the non-goals appear twice ('Do not use for' in When to Use and again as section 9 Non-Goals), and 'ultra-granular / line-by-line / block-by-block' is restated many times. It does not teach basic concepts, so it stays above anchor 1, but the duplicated and padded sections fit anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') better than anchor 3.

2 / 5

Actionability

As an instruction-only skill the checklists are genuinely concrete (per-function structure, 'Minimum 3 invariants per function', 'Minimum 5 assumptions documented', example phrasing like '"Unclear; need to inspect X"'), but key details are incomplete: sections 5.3-5.5 direct Claude to follow formats 'defined in OUTPUT_REQUIREMENTS.md', 'FUNCTION_MICRO_ANALYSIS_EXAMPLE.md', 'COMPLETENESS_CHECKLIST.md', and a 'function-analyzer' agent — none of which exist in the bundle. This matches anchor 3 ('some concrete guidance but incomplete... missing key details') rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

The process is clearly sequenced (Phase 1 orientation → Phase 2 per-function micro-analysis → Phase 3 global understanding → relationship to later phases) with most checkpoints present (completeness checklist, quality thresholds, anti-hallucination rules, 'report the inspected scope... do not claim complete understanding'). It falls short of anchor 5 because the worked example and the checklist file that would anchor the validation loop are missing, leaving minor validation gaps — anchor 4 fits.

4 / 5

Progressive Disclosure

Section headers are well organized and the 'Catalog scope' section honestly flags that no bundle files ship, but the body still instructs Claude to consult three nonexistent .md files and an agent definition, and ~300 lines of process detail (output format, example walkthrough, checklist) are inlined that clearly belong in separate reference files. This fits anchor 3 ('some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline').

3 / 5

Total

12

/

20

Passed

Description

53%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 third-person and names a specific niche with a couple of concrete actions, but it lacks an explicit 'Use when...' trigger clause and misses natural synonyms (audit, code review, codebase understanding). It sits at the midpoint of the rubric: clear on 'what', weak on 'when'.

Suggestions

Add an explicit trigger clause, e.g. 'Use when preparing for a security audit, code review, or threat model, or when the user asks to deeply understand a codebase before finding bugs.'

Include natural synonyms users would say — 'audit', 'code review', 'understand the codebase' — alongside 'vulnerability' and 'bug finding'.

State 1-2 more concrete deliverables of the context-building (e.g., 'maps invariants, assumptions, and trust boundaries per function') to round out the 'what'.

DimensionReasoningScore

Specificity

The description names the domain and 1-2 concrete actions ("line-by-line code analysis to build deep architectural context") but coverage is not comprehensive — it never states what the resulting context is used for beyond a vague 'before vulnerability or bug finding'. Phrases like 'ultra-granular' and 'deep architectural context' border on buzzword. This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') better than anchor 4, which expects several distinct listed actions.

3 / 5

Completeness

The 'what' is clear (enables line-by-line analysis to build context), but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'before vulnerability or bug finding' only weakly implies when. Per the guideline, a missing explicit 'Use when' clause caps completeness at 3 — this matches anchor 3 ('clear what but when is missing or only weakly implied'), not anchor 4 which requires both present.

3 / 5

Trigger Term Quality

Relevant keywords are present ('code analysis', 'vulnerability', 'bug finding', 'architectural context') but common natural variations users would actually say are missing: 'audit', 'code review', 'understand this codebase', 'threat model'. This fits anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (context-building phase preceding vulnerability finding) and explicitly signals it stops before findings, making it mostly distinct from general code-review or bug-hunting skills. Minor overlap risk remains with generic 'understand the code' or code-review skills, so anchor 4 ('mostly distinct; minor overlap risk') fits better than anchor 5's minimal-conflict bar.

4 / 5

Total

13

/

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

sickn33/agentic-awesome-skills

Path

skills/audit-context-building/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.