CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

talk-stack-humans-architect-ai-writes-code

Explains Paul Stack's architecture-first AI workflow and helps create safe design artifacts: intent documents, architecture constraints, planner/reviewer loops, UAT criteria, and agent-output review gates. Use when the user asks about humans owning architecture while agents implement, why vibes do not scale, or applying the talk to team workflow design.

Quality

84%

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

71%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, lean instruction skill with concrete templates and clear workflows, undermined by its bundle: the Read Order directs Claude to files that do not exist in the skill as shipped. Minor redundancy (duplicated redaction rule, redundant artifact list) and the lack of a worked example keep the mid-tier dimensions at 4.

Suggestions

Ship the referenced bundle files (outline.md, quote.md, transcript.md) under references/ — the Read Order currently points to files absent from the bundle, so progressive disclosure breaks at runtime.

Consolidate the duplicated redaction guidance (Read Order item 4 and the final Core Workflow paragraph) and fold 'What This Skill Produces' into the Output Templates section to remove redundancy.

Add one worked example of a completed artifact (e.g., a filled-in intent document or UAT checklist) so the templates are immediately actionable without inference.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence with no concept re-teaching, but 'What This Skill Produces' restates the artifact list already given in the description and templates, and the redaction rule is stated twice (Read Order item 4 and the closing Core Workflow paragraph).

4 / 5

Actionability

Numbered workflows, fill-in output templates, decline rules, and two response-shape examples give mostly executable guidance, but there is no worked example of a completed artifact and the factual-question workflow depends on outline.md content that is never surfaced.

4 / 5

Workflow Clarity

Two clearly sequenced workflows with guardrail steps ('State when the bundle does not cover a requested detail', 'Reject output that cannot be reviewed against intent'), but there is no verify/fix/retry loop confirming the produced artifact meets the UAT criteria before presenting it.

4 / 5

Progressive Disclosure

The Read Order is well-signaled and one level deep, but the referenced bundle files (outline.md, quote.md, transcript.md) are absent from the bundle, so the navigation the skill depends on cannot complete at runtime. The body itself is well organized, keeping this above the lower anchors.

3 / 5

Total

15

/

20

Passed

Description

92%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: third-person, explicit what and when, concrete enumerated artifacts, and talk-specific triggers that make conflict unlikely. The only gap is modest synonym coverage in the trigger clause.

DimensionReasoningScore

Specificity

'Explains Paul Stack's architecture-first AI workflow and helps create safe design artifacts: intent documents, architecture constraints, planner/reviewer loops, UAT criteria, and agent-output review gates' enumerates five concrete artifacts across two concrete actions, matching the comprehensive multi-action anchor rather than the minor-gaps anchor below it.

5 / 5

Completeness

Both halves are explicit: the what ('Explains... and helps create safe design artifacts: ...') and the when ('Use when the user asks about humans owning architecture while agents implement, why vibes do not scale, or applying the talk to team workflow design') with three concrete trigger phrases.

5 / 5

Trigger Term Quality

'humans owning architecture while agents implement', 'why vibes do not scale', and 'applying the talk to team workflow design' are natural talk-specific phrases, but coverage stops short of the synonym-level completeness of the top anchor (e.g., the talk-title wording itself or 'AI coding agents' is missing).

4 / 5

Distinctiveness Conflict Risk

'Paul Stack's architecture-first AI workflow' pins a clear niche and every trigger is talk-specific, leaving minimal overlap risk with generic architecture or design-document skills.

5 / 5

Total

19

/

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-stack-humans-architect-ai-writes-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.