CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

talk-podjarny-skills-are-the-new-code

Assists with questions about Guy Podjarny's talk "Skills are the new Code". Use when the user wants to understand, apply, audit, or explore frameworks from this keynote — including the five engineering disciplines for skills (static analysis, evals, security testing, dependency management, observability), the three challenge buckets, the agentic development stack, or concepts like skill authoring, context engineering, agent harnesses, and skill quality scoring.

Quality

86%

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

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 disciplined, lean reference skill with a well-sequenced workflow, explicit validation checkpoints, and thorough failure-mode handling. Its main gaps are minor: a repeated evidence-separation rule, a crosswalk template with only one of five discipline rows, and referenced bundle files (outline.md, quote.md, transcript.md) that are not actually present in the bundle.

Suggestions

State the talk-evidence vs project-evidence separation rule once (e.g., in Workflow) and have Validation reference it, instead of restating it across Outputs, Workflow step 7, and Validation.

Show the full crosswalk table with all five discipline rows (static analysis, evals, security testing, dependency management, observability) or a note that rows follow outline.md's framework list, rather than only the Evals example row.

Ship outline.md, quote.md, and transcript.md in the skill bundle (e.g., under references/) or state their expected location, so the referenced navigation paths resolve.

DimensionReasoningScore

Conciseness

The body is lean and instruction-only with no explanations of concepts Claude already knows, but the rule to keep talk evidence separate from project evidence is repeated in Workflow step 7 ("Keep talk evidence separate from repository evidence"), Outputs ("keeps the talk evidence separate from the project evidence"), and Validation ("no project-behavior claim rests on the talk alone"). This matches anchor 4 (minor instances that could be trimmed) rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Guidance is concrete and executable: ordered file reads ("Read `outline.md` to locate the relevant section"), a defined citation format (safe excerpt, line range, labelled paraphrase), a crosswalk table with explicit row classifications ("present / gap / unknown"), and per-condition failure fallbacks. It stops short of anchor 5 because the crosswalk table shows only one example row (Evals) of the five disciplines and no worked example of a grounded answer. As an instruction-only skill, absence of code is not penalized.

4 / 5

Workflow Clarity

A clear 7-step sequence is paired with an explicit Validation checklist ("confirm that every substantive claim is supported by the relevant transcript lines... Report this evidence as `pass`, `fail`, or `blocked`") and a Failure Mode section with error-recovery paths for missing files, uncovered topics, multi-section questions, and unauthorized audits. This matches anchor 5 (explicit validation steps, feedback loops, checklist); anchor 4's 'minor validation gaps' does not apply. The skill is read/answer oriented, so the destructive/batch cap is not triggered.

5 / 5

Progressive Disclosure

References are well signaled and one level deep: a dedicated References section with one-line descriptions for `outline.md`, `quote.md`, and `transcript.md`, used consistently in Inputs and Workflow. However, none of the three referenced files exist in the bundle (no references/ directory is present), so navigation does not resolve — a minor organization/structure gap that places it at anchor 4 rather than anchor 5's easy navigation.

4 / 5

Total

17

/

20

Passed

Description

87%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 strong description with an explicit third-person 'what', a concrete 'Use when...' trigger clause, and a rich inventory of talk-specific keywords. Trigger coverage is good but misses a few natural synonyms for the talk and speaker's companies, and the action verbs are slightly abstract.

DimensionReasoningScore

Specificity

The description names concrete actions ("understand, apply, audit, or explore frameworks") and enumerates specific content areas including the named disciplines ("static analysis, evals, security testing, dependency management, observability") and "the three challenge buckets". It falls short of anchor 5 because the actions are generic verbs rather than multiple fully concrete operations, but exceeds anchor 3's '1-2 concrete actions' bar through its enumerated framework inventory.

4 / 5

Completeness

It explicitly answers both questions: the 'what' is stated in third person ("Assists with questions about Guy Podjarny's talk... apply, audit, or explore frameworks") and the 'when' is an explicit "Use when the user wants to understand, apply, audit, or explore frameworks from this keynote" clause with concrete trigger topics enumerated. This matches anchor 5; anchor 4's caveat ('when could be more explicit or specific') does not apply given the detailed trigger list.

5 / 5

Trigger Term Quality

Natural trigger terms a user would actually say are well covered: "Guy Podjarny", "Skills are the new Code", "keynote", "evals", "skill authoring", "context engineering", "agent harnesses", and "skill quality scoring". A few plausible natural terms are missing (e.g., "Tessl", "Snyk", "skill engineering"), which places it at anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description targets a single named keynote by a named speaker with talk-specific frameworks ("the three challenge buckets", "the agentic development stack"), giving it a clear niche with distinct triggers and minimal risk of firing for an unrelated skill. This is a direct match to anchor 5.

5 / 5

Total

18

/

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

Path

Plugins/aidevcon/skills/talk-podjarny-skills-are-the-new-code/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.