AGENTS.md

1# ASYNKRON Developer Tools
2 
3This repository contains reusable developer tool skills. Each skill is a self-contained instruction set in `skills/<name>/SKILL.md`.
4 
5## Available Skills
6 
7### General (any language)
8 
9- **[api-dog-food](skills/api-dog-food/SKILL.md)** — Evaluate APIs through real tasks, measure the value and quality of their data, and produce evidence-backed keep, improve, combine, or retire decisions
10- **[cloc](skills/cloc/SKILL.md)** — Count lines of code, analyze codebase size and language breakdown
11- **[quickdup](skills/quickdup/SKILL.md)** — Detect code duplication, find clones, reduce codebase size. Includes 4 refactoring patterns for different duplication types
12- **[systematic-debug](skills/systematic-debug/SKILL.md)** — Systematic debugging with test bombs (hypothesis elimination) and layered tests (pipeline stage isolation)
13- **[continue-loop](skills/continue-loop/SKILL.md)** — Keep iterating on the next project step, with persisted loop state and verification records
14- **[palette](skills/palette/SKILL.md)** — Generate color palettes with Tailwind-scale shades using OKLCH. Supports color wheel strategies, mood presets (vibrant/pastel), and automatic normalization
15- **[uxly](skills/uxly/SKILL.md)** — Scan web pages for UI consistency issues via Chrome DevTools MCP. Detects misalignment, bad contrast, near-miss colors, inconsistent spacing, font sizes, and 40+ other design system violations. Includes pixel-accurate contrast sampling
16- **[hotmess](skills/hotmess/SKILL.md)** — Git churn analysis. Auto-detects clusters of high-churn code (by directory, filename stem, and co-change), classifies them (hotspot / spec-drift / rewrite / active dev / stable), and explains why each cluster is a problem. Optional Mermaid HTML module map.
17 
18### .NET Specific
19 
20- **[profile](skills/profile/SKILL.md)** — Profile .NET apps for CPU, memory, contention, exceptions, heap, and JIT inlining. Includes profiling methodology and JIT-aware optimization patterns
21- **[testrunner](skills/testrunner/SKILL.md)** — Alternative .NET test runner for flaky, hanging, crashing, OOM, and stack overflow tests. Only use when `dotnet test` fails
22- **[roslynator](skills/roslynator/SKILL.md)** — C# static analysis, auto-fix, formatting, and dead code detection
23- **[dotnet-strict](skills/dotnet-strict/SKILL.md)** — Apply strict .NET coding standards: adds Roslynator + Meziantou analyzers and a comprehensive .editorconfig with 80+ rules
24- **[pre-pr](skills/pre-pr/SKILL.md)** — Pre-PR quality gate: roslynator fix → build → test → duplication check → format → PR
25 
26## How to Use
27 
28Read the relevant `SKILL.md` file for the task at hand and follow its instructions. Each skill includes:
29 
30- Prerequisites and installation
31- Common usage patterns
32- Key flags and options
33- Methodology and guidelines
34