caidanw/skills

git-worktree

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

لغة النص الأصلي: الإنجليزية

technical-writing

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

لغة النص الأصلي: الإنجليزية

typescript

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

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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.

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

update-readme

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

لغة النص الأصلي: الإنجليزية

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:…

لغة النص الأصلي: الإنجليزية

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,…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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:…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية

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.…

لغة النص الأصلي: الإنجليزية

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…

لغة النص الأصلي: الإنجليزية