Claude Skills by ulises-jeremias

This guide walks you through adding a new skill to agent-toolkit from scratch. A skill is a portable, self-contained capability definition that tells an AI coding assistant what to do in a specific situation. Skills live under `skills/<domain>/<skill-name>/` and consist of exactly one required file: `SKILL.md`. ---

WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when

WHAT - Capture explicit agreements, terms, parties involved, dates, validity, and linked

WHAT — Create polished dark-themed architecture diagrams as self-contained HTML+SVG files (inline SVG, CSS styling, PNG/PDF export toolbar). Use when the user asks for system, infrastructure, cloud, security, or network topology diagrams rendered as a shareable visual artifact rather than code.

Assistant — on any repo, scan README→docs→AGENTS→CONTRIBUTING→PR templates→task runners→devcontainer→CI→configs

WHAT — AWS Well-Architected Framework review (6 pillars) — operational excellence, security, reliability, performance, cost, sustainability + WAR process. Checklist for workload evaluation on AWS; complementary to official AWS MCP for live account data.

Find what a change could break somewhere else before it ships, beyond the diff, and prove the one fact it's safe because of by running real code instead of writing it up. Use for 'blast radius of X', 'what could this break', or reviewing a small diff you don't trust.

WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be

WHAT — C4 model methodology (Context, Container, Component, Code) guidance — what to draw at each level, when, and how to render C4-inspired diagrams via Mermaid (PlantUML/Structurizr optional advanced). Methodology not renderer.

Use Chrome DevTools MCP to control and inspect a live Chrome instance for network, console, performance, rendering, and Deep debugging. Pairs with playwright-cli (deterministic interaction/E2E) — complements, not duplicates.

Designs or reviews CLIs so coding agents can run them reliably: non-interactive flags, layered --help with examples, stdin/pipelines, fast actionable errors, idempotency, dry-run, and predictable structure. Use when building a CLI, adding commands, writing --help, or when the user mentions agents, terminals, or automation-friendly CLIs.

ClickUp CLI for managing tasks, sprints, comments, statuses, and Docs. Use when the user

WHAT — Vendor-neutral distributed cloud patterns (Retry, Bulkhead, Circuit Breaker, CQRS, Event Sourcing, etc.) abstracted from AWS/Azure/GCP sources — when to apply, tradeoffs, mapping to AWS/GCP/Azure primitives. Offline checklist, no live account required.

CodeQL operational workflow — discover/config, run/inspect, triage SARIF findings (rule/query ID, source→sink, evidence), remediate, re-validate. Distinguishes broad MegaLinter linting from semantic security analysis.

Confluence administration including users, groups, space settings, and permission diagnostics. Use when managing user access, group membership, viewing space configuration, or checking permissions.

View analytics, statistics, and popularity metrics for Confluence content. ALWAYS use when user wants to see views, popularity, or contributor stats.

Central hub for Confluence operations - routes requests to specialized skills. ALWAYS use when user mentions confluence, wiki, or Atlassian wiki operations.

Manage file attachments - upload, download, list, and delete attachments. ALWAYS use when user wants to work with files on pages.

Bulk operations for 50+ pages - updates, moves, deletions, labels, and permissions. Use when updating multiple pages simultaneously (dry-run preview included), needing rollback safety, or coordinating team changes. Handles partial failures gracefully.

Manage comments on Confluence pages - add, get, update, delete, and resolve comments. ALWAYS use for feedback, discussions, and inline annotations.

Navigate and manage Confluence page hierarchies, ancestors, descendants, and trees. ALWAYS use for parent/child relationships and page tree navigation.

JIRA integration - embed issues, create links between products. ALWAYS use when user wants to connect Confluence and JIRA.

Manage content labels - add, remove, and search by labels. ALWAYS use when user wants to tag, label, or categorize content.

Cache management, API diagnostics, and operational utilities. Use when optimizing performance, managing cache, diagnosing API issues, or troubleshooting Confluence connectivity.

Manage Confluence pages and blog posts - create, read, update, delete, copy, move, and version control. ALWAYS use when user wants to work with page content, create pages, update pages, or manage page versions.

Manage space and page permissions and restrictions. ALWAYS use when user wants to control access, set restrictions, or manage who can view/edit content.

Manage content properties (custom metadata) on Confluence pages and blog posts. ALWAYS use for custom metadata, key-value data, or application-specific fields.

Search Confluence using CQL queries, validate syntax, export results, and manage search history. ALWAYS use when user wants to find, search, or query for content.

Manage Confluence spaces - create, list, update, delete, and configure spaces. ALWAYS use when user wants to work with spaces (not individual pages).

Work with page templates and blueprints. ALWAYS use when user wants to create standardized pages or manage templates.

Content watching and notifications. ALWAYS use when user wants to follow content or manage notifications.

HOW — Run dbt checks as documented in the target repo (parse, compile, test, selective run).

WHAT - Capture lightweight project, product, or operational decisions that do not require

Evidence-based deep code review rubric — severity + confidence findings across maintainability, correctness, security, performance, and testing. Push for ambitious structural simplification (code judo), not just local cleanup. Escalate hands-on triage to the code-reviewer agent.

WHAT - Evidence-based design-unit assessment orchestrated by project-assessment. Evaluates visual hierarchy, UX friction, interaction, a11y, responsiveness, design-system compliance, and distinctiveness with severity/confidence evidence citations. Reuses project-assessment-evidence semantics — no second framework.

WHAT - Browser-grounded iterative design improvement. Consumes design-assessment findings, defines direction, prioritizes safe vs ambiguous changes, implements within existing design system, runs app, captures rendered evidence via browser, reviews and iterates. Reuses evidence model — no new scoring framework.

Remove AI-generated code slop and clean up code style

'WHAT — Dev Companion (general): layered companion for client delivery; modes, gates, delegation

WHAT - Default development workflow, task lifecycle, DoR, DoD, validation, and evidence model

'WHAT — Generate or update documentation from code: README.md from repo structure, CHANGELOG.md

WHAT - Draft and review epics using the Best Practices Epic Template; includes objectives,

Connects Figma design components to code components using Code Connect mapping tools. Use

Generates custom design system rules for the user's codebase. Use when user says "create

Create a new blank Figma file. Use when the user wants to create a new Figma design or FigJam

Translates Figma designs into production-ready application code with 1:1 visual fidelity.

Use the Figma MCP server to fetch design context, screenshots, variables, and assets, and

Resolve merge conflicts non-interactively, validate build and tests, and finalize conflict resolution

'Review and create distinctive, production-grade frontend interfaces with high design quality

Guidance for distinctive, intentional visual design when building new UI or reshaping an

Triage and address open GitHub PR review and conversation comments using the gh CLI. Use