CtrlK
BlogDocsLog inGet started
Tessl Logo

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

Use when the user asks about Paul Stack's talk "The Humans Architect the System, the AI Writes the Code" (System Initiative / Eldest One Club, 2026) — including questions about why his team stopped writing code, the no-PR open-source policy, CLAUDE.md as executable constraints, the planner/adversarial-reviewer loop, swamp the AI-native ops CLI, UAT as source of truth, "vibes don't scale", "intent is the new architecture", supply-chain integrity in AI-era OSS, or applying his architecture-first / agents-write-all-code workflow to the user's own team.

62

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./talk-stack-humans-architect-ai-writes-code/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured reference skill with strong actionability and clear workflows for multiple use cases (Q&A, auditing, artifact drafting, proactive surfacing, teaching). Its main weaknesses are moderate verbosity from repeated instructions across sections (especially the 'read outline.md, then transcript.md, quote verbatim' pattern) and the inability to verify referenced bundle files. The grounding rules and transcript-artifact handling instructions are genuinely valuable and non-obvious.

Suggestions

Consolidate the repeated 'read outline.md → find section → read transcript.md → quote verbatim' pattern into a single 'Standard lookup procedure' section referenced by each workflow, reducing redundancy across the five workflow types.

Add a brief quick-start or summary section at the top (after grounding rules) that lists the five workflow types as a table of contents so Claude can quickly identify which workflow applies.

DimensionReasoningScore

Conciseness

The skill is moderately efficient — it provides necessary structure for a complex reference task, but some sections are repetitive (e.g., 'read outline.md then transcript.md' and 'quote verbatim' instructions are repeated across nearly every section). The grounding rules and per-workflow instructions could be consolidated to reduce redundancy.

2 / 3

Actionability

Each workflow section provides concrete, step-by-step instructions with specific actions (e.g., 'read outline.md → Named frameworks / concepts', enumerate exact dimensions for auditing, list specific CLAUDE.md constraints to capture). The guidance is precise and directly executable by Claude without ambiguity.

3 / 3

Workflow Clarity

Multi-step processes are clearly sequenced with numbered steps across all five workflow types. The audit workflow includes explicit validation ('Ask before scoring any the user hasn't described') and the artifact-drafting workflow includes a verification step ('Mark anything you add beyond what Paul prescribed'). Each workflow has clear decision points and error handling (e.g., 'If the framework genuinely doesn't fit, say so').

3 / 3

Progressive Disclosure

The skill references external files (outline.md, transcript.md, quotes.md) appropriately and with clear navigation signals, but no bundle files are provided to verify these references exist. The SKILL.md itself is fairly long with all workflow types inline rather than split into separate files, though for a reference-heavy skill this is borderline acceptable. The content could benefit from a quick-start summary before diving into five detailed workflow sections.

2 / 3

Total

10

/

12

Passed

Description

72%Scale 1-3

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 excels at specifying when to trigger (with rich, specific keywords tied to a unique talk) and is highly distinctive, but it completely omits what the skill actually does — there are no action verbs or capability statements. It reads as a pure trigger-matching clause without explaining the skill's function or output.

Suggestions

Add a 'what it does' clause at the beginning, e.g., 'Answers questions about and summarizes key insights from Paul Stack's talk...' to clarify the skill's purpose.

Include action verbs describing concrete capabilities, such as 'explains concepts', 'provides quotes or examples from the talk', or 'helps users apply the architecture-first workflow to their own teams'.

DimensionReasoningScore

Specificity

The description names a specific domain (Paul Stack's talk) and lists several concrete topics (no-PR policy, CLAUDE.md as executable constraints, planner/adversarial-reviewer loop, swamp CLI, etc.), but it doesn't describe what the skill actually *does* — it only lists topics it covers. There are no action verbs describing capabilities like 'summarizes', 'explains', or 'applies insights from'.

2 / 3

Completeness

The 'when' is explicitly and thoroughly addressed with 'Use when the user asks about...' and extensive trigger scenarios. However, the 'what does this do' is essentially missing — it never states what the skill provides (e.g., answers questions, summarizes key points, provides analysis). The description only specifies when to activate, not what it delivers.

2 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms a user might say: 'Paul Stack', 'System Initiative', 'no-PR open-source policy', 'CLAUDE.md', 'vibes don't scale', 'intent is the new architecture', 'AI-native ops CLI', 'swamp'. These are highly specific phrases a user would naturally use when asking about this talk.

3 / 3

Distinctiveness Conflict Risk

This is extremely distinctive — it's about a specific person's specific talk with highly unique trigger terms like 'Paul Stack', 'Eldest One Club', 'swamp the AI-native ops CLI', and 'vibes don't scale'. There is virtually no risk of conflicting with other skills.

3 / 3

Total

10

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
AINativeDev/aidevcon-2026-ldn
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.