caidanw/skills

git-worktree

Create, remove, and list git worktrees in a standardized location

Idioma del texto original: inglés

technical-writing

Write clean, terse technical docs — commits, issues, PRDs, specs, and technical communication

Idioma del texto original: inglés

typescript

Write clean, pragmatically functional TypeScript — simple, composable, soundly typed

Idioma del texto original: inglés

clear-communication

Use clear, natural, reader-centered language for all agent communication. Apply when the user asks for plain language, clear communication, writing inspired by Simplified Technical English or ISO 24495-1, or Orwell-style clarity. Enable a persistent mode only…

Idioma del texto original: inglés

adversarial-review

Adversarially hunt for correctness bugs and regressions in a change set. Use when reviewing a diff before finalizing, during a cleanup pass, or when asked to find bugs, pressure-test, or stress-test recently modified code. Triggers on "find bugs", "what could…

Idioma del texto original: inglés

cleanup-swift

End-of-session cleanup pass for Swift code. Use this skill whenever the user asks to "clean up", "polish", "tidy", "refactor", or "review" Swift work at the end of a coding session, or when they invoke this skill by name. Performs a holistic review of session…

Idioma del texto original: inglés

macos-swift-desktop

Build native macOS desktop applications in Swift using AppKit and SwiftUI. Use when building or modifying macOS .app bundles, NSDocument-based apps, menu bar apps, preferences windows, NSWindow/NSToolbar/NSSplitView layouts, NSMenu/NSStatusItem, Core…

Idioma del texto original: inglés

cleanup-web

End-of-session cleanup pass for TypeScript, React, and web code. Use this skill whenever the user asks to "clean up", "polish", "tidy", "refactor", or "review" web/frontend work at the end of a coding session, or when they invoke this skill by name. Performs…

Idioma del texto original: inglés

simplify

Simplify and refine recently modified code for clarity and consistency. Use after writing or modifying code, during cleanup passes, or when asked to simplify/refactor without changing behavior.

Idioma del texto original: inglés

pr-review-triage

Pull PR review comments and triage them — separate substantive feedback from bikeshedding, stale comments, misreads, AI slop, and other noise. Use this skill whenever the user asks to "review my PR comments", "triage feedback", "go through my PR", or wants…

Idioma del texto original: inglés

design-patterns-gof

The 23 Gang of Four object-oriented design patterns (Gamma, Helm, Johnson, Vlissides, 1994) distilled as a practical field guide, not a catalog. Use when naming a shape in code review, choosing between competing designs, deciding whether to introduce…

Idioma del texto original: inglés

update-readme

Use when adding, removing, or renaming a skill in this repository to keep the Available Skills table in README.md current.

Idioma del texto original: inglés

git-safe-pr-workflow

Safe GitHub pull request workflow for low-experience Git users. Use when pulling, syncing a feature branch with `main`, resolving conflicts, undoing mistakes, recovering from a bad rebase, or deciding how to merge a PR while keeping `main` clean. Triggers on:…

Idioma del texto original: inglés

no-use-effect

Prevent unnecessary React `useEffect` usage by steering code toward derived state, event handlers, memoization, `key`-based resets, `useSyncExternalStore`, and framework or query-library data APIs. Use when writing or reviewing React/Next.js components,…

Idioma del texto original: inglés

code-comments

Write high-signal code comments for humans and coding agents. Use when adding inline comments, docstrings, API comments, or local rationale near code. Triggers on: "write better comments", "comment this", "document why", "agent-friendly comments", "explain…

Idioma del texto original: inglés

design-system

Build design system components and UI that are accessible, themeable, and visually polished. Use when building buttons, dialogs, forms, cards, or any reusable UI components. Covers component API design, design tokens, accessibility, theming, visual design…

Idioma del texto original: inglés

typescript-refactoring

Systematically refactor TypeScript codebases for readability, type safety, and AI-friendliness. Use when asked to "refactor this", "clean up this code", "make this codebase better", "improve code quality", or when inheriting a messy TypeScript project. Covers…

Idioma del texto original: inglés

distill-to-skill

Distill knowledge from any source — blog posts, articles, documentation, GitHub repos, video transcripts, books, papers — into a well-structured agent skill. Use when the user shares a URL, article, repo, or body of knowledge and wants it turned into a…

Idioma del texto original: inglés

agents-md

Write effective AGENTS.md files that give coding agents the context they need to work in a repository. Use when creating a new AGENTS.md, improving an existing one, setting up a repo for AI coding agents, or onboarding agents to a codebase. Triggers on:…

Idioma del texto original: inglés

agent-first-repo

Structure a repository and its documentation so AI coding agents can work effectively. Covers knowledge hierarchy, progressive disclosure, mechanical enforcement of architecture, and entropy management. Use when setting up a new project for agent-first…

Idioma del texto original: inglés

parse-dont-validate

Type-driven design principle: transform unstructured data into structured types at system boundaries, making illegal states unrepresentable. Use when writing or reviewing code that validates input, designs data types, defines function signatures, handles…

Idioma del texto original: inglés

architecture-md

Generate an ARCHITECTURE.md file for a codebase following matklad's principles. Use when asked to "write an architecture doc", "create ARCHITECTURE.md", "document the architecture", "explain the codebase structure", "write a codemap", or when onboarding…

Idioma del texto original: inglés

lean-ts-patterns

Patterns for building lightweight, zero-dependency TypeScript tools and libraries. Use when building new CLI tools, libraries, or utilities from scratch. Use when refactoring existing TypeScript projects to remove unnecessary dependencies. Use when writing…

Idioma del texto original: inglés

behavioral-testing

Behavioral testing methodology — test what users experience, not how code is structured. Use when writing tests, reviewing test quality, planning test strategy for new features, or when existing tests are brittle/verbose/coupled to implementation details.…

Idioma del texto original: inglés

modern-css

Teaches agents to write modern CSS using native features instead of legacy hacks, workarounds, and JavaScript. Covers layout, animation, color, typography, selectors, and workflow patterns with 64 old-vs-modern comparisons. The agent should always prefer…

Idioma del texto original: inglés