lexler/skill-factory

hotspots

Find where a codebase actually costs time by mining its git history (Tornhill hotspot analysis). Produces ranked refactoring targets with evidence, change-coupling seams, and a do-not-refactor list; re-run after refactoring to verify it paid off.

writing-great-skills

Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.

demo-with-narration

Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough. Use when the user asks for a demo or to be shown that something works.

extract-knowledge

Extracts what the session learned into prose that stands alone, or reviews existing text through the same distortion lenses.

nullables

Nullables — testing technique alternative to using mocking libraries. Use when writing unit tests, when code touches external I/O or state (HTTP, databases, files, clock, random) anywhere in its dependency chain, when making a system testable, or when tests…

writing-bash-scripts

Bash script style guide. Always use when writing bash scripts, shell scripts, or CLI bash tools.

playwright-cli

Drive a browser from the terminal with playwright-cli: snapshot the page, then act on elements by ref. Use when automating browser interactions, filling web forms, testing UIs, or driving logged-in web apps from the command line.

socratic-learning

Facilitates deep, structured learning of a topic — gathering source material, assessing the learner's gaps, then teaching through guided Socratic sessions. Use when someone wants to genuinely study or be tutored on a subject over time, not get a quick answer.

c4-diagrams

Creates C4 architecture diagrams for designing, documenting, or understanding software architecture. Use when working through system design, mapping existing codebases, or visualizing structure at any level from system landscape down to code.

tdd

Test-driven development (TDD) process used when writing code. Use whenever you are adding any new code, unless the user explicitly asks to skip TDD or the code is exploratory/spike.

align

Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives. Use when aligning on a design, plan, or technical approach before implementation.

refactoring-team

Iterative code refactoring through progressive lenses via a worker-reviewer agent team.

launching-agent-teams

Launches agent teams with structured roles and task decomposition. Use when asked to create a team, spawn teammates, or coordinate multiple agents in parallel.

growing-outside-in-systems

Drive feature development using Outside-In TDD with Hexagonal Architecture. Design emerges through inline code, in-memory fakes, interface extraction, and deferred I/O. Use when building features, writing tests, or structuring backend services. Triggers on:…

writing-statuslines

Writes Claude Code status line scripts. Use when creating, customizing, or debugging statusline configurations.

creating-process-files

Creates process files - text as code instructions for reliable AI workflows. Use when creating new process files.

event-modeling

Designs systems using Event Modeling.

refinement-loop

Iterative refinement through multiple passes. Use when the user asks to 'meditate on', 'distill', 'refine', or 'iterate on' something, or proactively when a problem benefits from multiple passes rather than a single attempt.

collaborative-design

Designs software features collaboratively through visual scenarios and iterative refinement. Use when designing features, tools, UIs, workflows, or any system before implementation.

hexagonal-architecture

Applies hexagonal (ports & adapters) architecture. Use when designing application structure, separating domain from infrastructure, creating testable boundaries, or when user mentions ports, adapters, hexagonal, or clean architecture.

refactoring

Refactoring process. Invoke immediately when user or document mentions refactoring, or proactively when code gets too complex or messy.

creating-hooks

Creates Claude Code hooks.

ai-patterns

Reference patterns for augmented coding with AI. Use when discussing AI coding patterns, anti-patterns, obstacles, context management, steering AI, or looking up Lexler's patterns collection.

git-worktrees

Creates git worktrees for parallel development. Use when creating a git worktree, setting up multiple working directories, or working on features in parallel.

using-uv

Python package and project management with UV. Use when creating Python scripts, initializing projects, or managing dependencies.

approval-tests

Writes approval tests (snapshot/golden master testing) for Python, JavaScript/TypeScript, or Java. Use when verifying complex output, characterization testing legacy code, testing combinations, or working with .approved/.received files.

bdd-with-approvals

Scannable BDD tests written in domain language. Use when doing BDD.