jwynia avatar

Competency Builder

This is a diagnostic framework for building training that actually produces capability instead of just content completion. It walks you through ten states from "no framework" to "framework operational," identifying symptoms like vague competencies (understands X vs. can do X), scenarios that are too clean, or missing feedback loops. The real value is in the specific tests and interventions at each state. If you're dealing with training where people complete courses but still can't perform, or you're stuck trying to serve multiple audiences with one-size-fits-none content, this gives you a structured way to diagnose what's broken and what to fix next. It's opinionated about observability: if you can't watch someone demonstrate it, it's not a competency.

skills.sh installs
434
GitHub stars
182
last updated
Aug 21, 2026

Install

$ npx -y skills add jwynia/agent-skills --skill competency-builder --agent claude-code

Installs into .claude/skills of the current project.

Files

Competency Builder Skill

Build and operate competency frameworks that produce capability—not just completion. Diagnose where competency development is stuck and guide the next step.

Core Principle

Competencies are observable capabilities, not knowledge states. If you can't watch someone demonstrate it, it's not a competency.


Diagnostic States

CF0: No Framework

Symptoms: Have training content but no competency structure. People complete training but can't apply it. Same questions keep getting asked.

Test:

  • What decisions do people need to make with this knowledge?
  • What mistakes indicate someone lacks competency?
  • Can you describe what a competent person can DO?

Intervention: Start with failure modes. List mistakes you've seen, questions that shouldn't need asking, things that take too long. Each failure mode suggests a competency that would prevent it.


CF1: Content-First Trap

Symptoms: Started by listing all the information people need to know. Training is comprehensive but competence is low. "We trained on that" but mistakes continue.

Sponsors

Details

Repository
github.com/jwynia/agent-skills
Categories
Documentation, AI & Agent Building
First seen
Jun 3, 2026

More from jwynia/agent-skills

All 118
1n8n-io avatarn8n-conventionsn8n-io/n8nQuick reference for n8n patterns. Full docs /AGENTS.md433skills.sh installs
2guia-matthieu avatarheadline-formulasguia-matthieu/clawfu-skills25+ proven headline formulas that stop the scroll, capture attention, and drive clicks. Templates and examples for every situation. Use when: Writing headlines 431skills.sh installs
3davila7 avatarc4-architecturedavila7/claude-code-templatesGenerate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize sof430skills.sh installs
4onewave-ai avatarskill-navigatoronewave-ai/claude-skillsThe 100th skill! Your intelligent guide to all 99 other skills. Recommends the perfect skill for any task, creates skill combinations, and helps you discover ca430skills.sh installs
5evoscientist avatarpaper-planningevoscientist/evoskillsGuides pre-writing planning for academic papers with 4 structured steps: story design (task-challenge-insight-contribution-advantage), experiment planning (comp428skills.sh installs
6jezweb avatargoogle-workspacejezweb/claude-skillsBuild integrations with Google Workspace APIs (Gmail, Calendar, Drive, Sheets, Docs, Chat, Meet, Forms, Tasks, Admin SDK). Covers OAuth 2.0, service accounts, r428skills.sh installs