Agent skill · writing content · aiskillstore
antipattern-catalog
Document technical debt, anti-patterns, and patterns to avoid from analyzed frameworks. Use when (1) creating a "Do Not Repeat" list from framework analysis, (2) categorizing observed code smells and issues, (3) assessing severity of architectural problems, (4) generating remediation suggestions, or (5) synthesizing lessons learned across multiple frameworks.
Why this skill is useful
Provides a structured approach to documenting and remediating technical debt and anti-patterns, which the AI wouldn't reliably generate on its own.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Anti-Pattern Catalog Documents technical debt and patterns to avoid. Process 1. Collect observations — Gather issues from Phase 1 & 2 analyses 2. Categorize — Structural, behavioral, observability, performance 3. Assess severity — Critical, major, minor, cosmetic 4. Generate remediation — Suggest fixes for each pattern 5. Create checklist — "Do Not Repeat" guidelines Anti-Pattern Categories Structural Anti-Patterns Issues with code organization, inheritance, and modularity. Pattern Symptom Example --------- --------- --------- Deep Inheritance 5+ levels of class hierarchy Agent → BaseAgent → RunnableAgent → ExecutableAgent → ... God Class One class with 50+ methods AgentExecutor doing routing, execution, memory, tools Circular Dependencies Module A imports B, B imports A agent.py ↔ tools.py Leaky Abstraction Implementation details exposed Base class assumes specific LLM response format Premature Abstraction Over-engineered for flexibility 5 interfaces for a single implementation Behavioral Anti-Patterns Issues with runtime behavior and logic. Pattern Symptom Example --------- --------- --------- Hidden State Mutation State changes not obvious tool.run() modifies agent's memory Implicit Contracts Undocumented assumptions Tools assume specific message format Silent Failures Errors swallowed except: pass in tool execution Infinite Loop Risk No termination guarantee No step limit on agent loop Race Conditions Concurrent state access Shared dict without locks Observability Anti-Patterns Issues with debugging and monitoring. Pattern Symptom Example --------- --------- --------- Hidden LLM Response Raw response not accessible Token counts unavailable Opaque Errors Generic error messages "Something went wrong" No Tracing Can't follow execution No request IDs, no spans Swallowed Context Information lost Tool error not fed back to LLM Missing Metrics No performance data No latency, token, or cost tracking Performance Anti-Patterns Issues affecting speed and resource usage. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/antipattern-catalog