CtrlK
BlogDocsLog inGet started
Tessl Logo

talk-lawson-agent-experience

Use when the user asks about Dana Lawson's talk "Built for Humans. Now Agents Are Here." (Netlify CTO, 2026) — including questions about Agent Experience (AX), the AX paradox, redesigning CLIs/build logs/deploy previews for agents, moving from APIs to capabilities, event-driven agent architectures, blueprints (skills/recipes/context/ADRs), software factories, autonomous development loops, sandbox + human-in-loop + audit/rollback trust principles, the expanded "builder persona," or applying Netlify's AX approach to the user's own platform.

60

Quality

76%

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 ./Plugins/aidevcon/skills/talk-lawson-agent-experience/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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-structured operational core for a talk-reference skill: six distinct workflows with explicit sequences, anti-hallucination validation checkpoints, and concrete verdict labels and markers throughout. The main weaknesses are repeated restatement of the quote/cite rules across every section and references to bundle files that are not verifiable in the provided bundle.

Suggestions

Consolidate the repeated per-section rules ('quote short, non-sensitive excerpts', 'read outline.md then transcript.md', 'cite line numbers') into the grounding rules once, and have each workflow reference them — this would cut roughly 15 lines of redundancy.

State where outline.md, transcript.md, and quote.md live in the bundle and roughly what they contain (line counts, section names) so the agent can navigate without guessing; also fix grammar glitches like 'a **safe excerpts** of how Lawson articulates'.

Add a fallback for when outline.md's expected sections ('Named frameworks / concepts', 'Terminology glossary', participants list) are absent or renamed, e.g. 'if the section is missing, search transcript.md directly' — every workflow currently hard-depends on that structure.

DimensionReasoningScore

Conciseness

The body is dense with actionable directives and explains nothing Claude already knows, but it restates the same core rules across all six workflow sections — 'quote short, non-sensitive excerpts', 'read outline.md then transcript.md', and 'cite line numbers' each appear roughly 5-6 times — which could be consolidated into the grounding rules. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'): the repetition is more than the minor instances anchor 4 tolerates, but there is no padded filler that would justify anchor 2.

3 / 5

Actionability

Each workflow gives concrete, executable guidance: numbered steps, specific verdict labels ('covered / partial / missing'), an explicit marker tag ('[not from talk — added as a starting placeholder]'), and embedded verbatim spec quotes ('mid structure machine readable error codes alongside that human text'). This matches anchor 4 ('mostly executable guidance... with minor gaps'): the gaps are that file locations for outline.md/transcript.md/quote.md are unspecified, the workflows assume particular outline.md sections ('Named frameworks / concepts', 'Terminology glossary') that cannot be verified, and a few grammar glitches ('a **safe excerpts**') slightly blur otherwise crisp steps.

4 / 5

Workflow Clarity

All six workflows are clearly sequenced with explicit validation and fallback checkpoints: 'If a claim isn't in transcript.md, say "the talk doesn't address this"', 'If the user hasn't described their state for a dimension, ask before scoring', 'Any parts that go beyond what Lawson explicitly prescribed, mark clearly', and 'If the answer genuinely isn't in the transcript, say so explicitly'. The audit workflow is a full per-dimension checklist with a closing summary, matching anchor 5 (clear sequence, explicit validation steps, error-recovery branches, checklists); these are not destructive or batch operations, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The body is well structured with clear section headers and clearly signaled one-level-deep references — outline.md for navigation, transcript.md for source text, quote.md with a dedicated 'Key quotes' section directing the agent to check it first. This matches anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps'): it falls short of 5 because the referenced bundle files (outline.md, transcript.md, quote.md) are not present in the provided bundle to verify, and no paths or file sizes are given, so the reference structure cannot be confirmed as navigable.

4 / 5

Total

16

/

20

Passed

Description

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

A highly distinctive, trigger-rich description for a single-talk reference skill, with excellent natural-keyword coverage including synonyms. Its main weakness is that the 'what' is only implied — it enumerates what users may ask about but never states what the skill does in response — leaving completeness and capability specificity in the middle of the scale.

Suggestions

Add an explicit 'what' statement naming the skill's concrete actions, e.g. 'Answers questions with verbatim transcript excerpts and line-range citations, audits platforms against Lawson's AX framework, and drafts artifacts to her specifications.'

Promote the skill's distinct workflows (apply the framework, audit, draft, teach, proactive surfacing) into the description as capability verbs so users and Claude can distinguish what the skill does from merely when it fires.

Consider trimming a few of the broadest theme terms (e.g. 'event-driven agent architectures', 'build logs') or keeping them clearly framed as 'questions about the talk' to reduce overlap risk with general agent-platform questions.

DimensionReasoningScore

Specificity

The description names the domain precisely ('Dana Lawson's talk "Built for Humans. Now Agents Are Here." (Netlify CTO, 2026)') and enumerates a specific, comprehensive topic scope (AX, AX paradox, blueprints, software factories, trust principles), but states only one capability — handling 'questions about' these topics and 'applying Netlify's AX approach' — rather than several concrete actions. It matches anchor 3 (domain plus 1-2 concrete actions): more specific than anchor 2's generic actions, but it does not list the multiple distinct actions (answer, cite, audit, draft) that anchor 4 requires.

3 / 5

Completeness

The 'when' is explicit and thorough ('Use when the user asks about...'), but the 'what' — what the skill actually does (answers questions with quoted excerpts, audits platforms against the framework, drafts artifacts) — is never stated, only weakly implied by the topic enumeration. This falls between anchor 2 (only 'when' present without 'what') and anchor 4 (both explicit), so it scores the midpoint: the implied 'what' keeps it above 2, but the lack of any explicit capability statement keeps it below 4.

3 / 5

Trigger Term Quality

The description covers natural terms a user would say comprehensively, including synonyms: speaker name, talk title, company and year, 'Agent Experience (AX)', 'AX paradox', 'CLIs/build logs/deploy previews', 'APIs to capabilities', 'blueprints (skills/recipes/context/ADRs)', 'software factories', 'autonomous development loops', 'sandbox + human-in-loop + audit/rollback', and 'builder persona'. This matches anchor 5's comprehensive coverage including synonyms; no natural variation for this niche topic is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche — one named talk by one named speaker — with distinct triggers, matching anchor 4 ('mostly distinct; minor overlap risk'). It is not a 5 because broad theme terms like 'event-driven agent architectures', 'build logs', and 'deploy previews' could pull this skill in for general agent-platform questions unrelated to the talk, creating minor overlap risk with skills covering agent architecture or CI/CD topics.

4 / 5

Total

15

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
jscraik/Agent-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.