New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Apex Azure Adr

by jonathan-vella in jonathan-vella/apex

ANALYSIS SKILL — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences.

MITAuto-check passedDevelopment

Install Apex Azure Adr

skills CLI
$ npx skills add jonathan-vella/apex --skill apex-azure-adr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jonathan-vella/apex apex-azure-adr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jonathan-vella/apex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/apex-azure-adr .claude/skills/apex-azure-adr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apex-azure-adr
GitHub stars
217
Token cost
~860 tokens
SKILL.md length
253 words
Files
5 (incl. references)
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

ANALYSIS SKILL — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences.

  • Works in 6 steps: One decision per ADR — keep ADRs focused… → Include alternatives — always document… → Map to WAF pillars — show impact on each… → …
  • : IaC code (06b/06t agents)
  • SKILL.md covers Output Naming, Rules, Steps and Reference Index
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Apex Azure Adr is an agent skill from jonathan-vella/apex. ANALYSIS SKILL — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences. WHEN: "create ADR", "document decision", "architecture decision record", "record why we chose", "WAF pillar justification", "trade-off analysis". DO NOT USE FOR: IaC code (06b/06t agents), diagrams (apex-python-diagrams), cost estimates (cost-estimate-subagent).

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/adr-template.md`, `references/example-prompts.md` and `references/guardrails.md`). Compatibility notes: Works with Claude Code, GitHub Copilot, VS Code, and any Agent Skills compatible tool; no external dependencies required.

It sits in Development, covering Architecture decision records. It works with Microsoft Azure and Python. The repository describes itself as: APEX turns Azure platform engineering requirements into verified, deploy-ready IaC — powered by GitHub Copilot agents, real-time pricing, and built-in compliance. The licence is MIT.

When your agent uses it

  • : IaC code (06b/06t agents)
  • Diagrams (apex-python-diagrams)
  • Cost estimates (cost-estimate-subagent)

Example prompts

  • “create ADR”
  • “document decision”
  • “architecture decision record”
  • “/apex-azure-adr”

Requirements

  • Compatibility (from SKILL.md): Works with Claude Code, GitHub Copilot, VS Code, and any Agent Skills compatible tool; no external dependencies required.

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. One decision per ADR — keep ADRs focused on a single decision
  2. Include alternatives — always document at least 2-3 considered and rejected
  3. Map to WAF pillars — show impact on each of the 5 Well-Architected pillars
  4. Link to requirements — reference the requirement that drove the decision
  5. Keep it concise — ADRs should be readable in 5 minutes
  6. Document both consequences — at least 1 positive and 1 negative

What it can do on your machine

Read from SKILL.md and the folder at commit b8e5908. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Works with Claude Code, GitHub Copilot, VS Code, and any Agent Skills compatible tool; no external dependencies required.

    From compatibility in the SKILL.md frontmatter.

Context cost

Apex Azure Adr loads about 860 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 102 tokens; SKILL.md has 253 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
When it runs · the whole SKILL.md, loaded when a task matches
~860
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jonathan-vella/apex at commit b8e5908, republished under its MIT licence (© jonathan-vella). 253 words, ~860 tokens.

Download SKILL.mdSave it as .claude/skills/apex-azure-adr/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
apex-azure-adr
description
**ANALYSIS SKILL** — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences. WHEN: "create ADR", "document decision", "architecture decision record", "record why we chose", "WAF pillar justification", "trade-off analysis". DO NOT USE FOR: IaC code (06b/06t agents), diagrams (apex-python-diagrams), cost estimates (cost-estimate-subagent).
compatibility
Works with Claude Code, GitHub Copilot, VS Code, and any Agent Skills compatible tool; no external dependencies required.
user-invocable
true
disable-model-invocation
false
argument-hint
project and architecture decision
license
MIT
metadata.author
jonathan-vella
metadata.version
1.0
metadata.category
document-creation

Azure Architecture Decision Records (ADR) Skill

Create formal Architecture Decision Records that document significant infrastructure decisions with Azure-specific context, WAF pillar analysis, and implementation guidance.

Output Naming

ADRs are saved to agent-output/{project}/ with one of two phase prefixes:

PhasePrefixStatus defaultTrigger
Step 3 (Design)03-des-adr-ProposedArchitect agent, design/planning language
Step 7 (As-Built)07-ab-adr-AcceptedAfter deploy, implemented/current-state language

Full filename: {prefix}NNNN-{kebab-title}.md (e.g., 03-des-adr-0001-use-cosmos-db-for-state.md). NNNN is 4-digit sequential per project.

The 07-ab-adr- ADR may differ from 03-des-adr- if implementation required changes — document deviations in the "Implementation Notes" section.

Rules

  1. One decision per ADR — keep ADRs focused on a single decision
  2. Include alternatives — always document at least 2-3 considered and rejected
  3. Map to WAF pillars — show impact on each of the 5 Well-Architected pillars
  4. Link to requirements — reference the requirement that drove the decision
  5. Keep it concise — ADRs should be readable in 5 minutes
  6. Document both consequences — at least 1 positive and 1 negative

Steps

  1. Gather context — decision context, alternatives, stakeholders
  2. Determine number — check existing ADRs in agent-output/{project}/ for next sequence
  3. Determine phase — design (03-des-) or as-built (07-ab-)
  4. Generate document — follow references/adr-template.md
  5. Include WAF analysis — map decision impact to all 5 pillars
  6. Document alternatives — list 2-3 with rejection reasons
  7. Self-check — run through references/quality-checklist.md

Reference Index

Load on demand:

ReferenceWhen to Load
references/adr-template.mdAuthoring the ADR (full template with all sections)
references/example-prompts.mdLooking for trigger phrasing / common ADR topics
references/quality-checklist.mdFinal self-check before saving
references/guardrails.mdDO/DON'T rules, anti-pattern table

© jonathan-vella, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in .github/skills/apex-azure-adr of jonathan-vella/apex.

  • SKILL.md
  • references/adr-template.md
  • references/example-prompts.md
  • references/guardrails.md
  • references/quality-checklist.md

Open the folder on GitHubat commit b8e5908

Compare with similar skills

Apex Azure Adr next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apex Azure Adr compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apex Azure Adr this skilljonathan-vella/apex217—~860Automated safety check: PassMIT
Design Doc MermaidSpillwaveSolutions/design-doc-mermaid1761 repos~5.6kAutomated safety check: PassNone
Create Vibe Featuremistralai/mistral-vibe5.1k—~1.4kAutomated safety check: PassApache-2.0
Docsbrickbots/PiFinder250—~6.2kAutomated safety check: PassGPL-3.0
Reviewable Design Docu-ichi/reviewable-html-workbench2981 repos~8.6kAutomated safety check: PassMIT
Write Vibe ADRmistralai/mistral-vibe5.1k—~942Automated safety check: PassApache-2.0

Similar skills

  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    176 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed

  • Create Vibe Feature

    mistralai/mistral-vibe

    Official

    Guides feature work in the Mistral Vibe Python CLI so each change lands in the right module and matches the project's architecture decision records.

    5.1k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Docs

    brickbots/PiFinder

    Author and edit PiFinder's user-facing documentation in the project's house style.

    250 GitHub stars~6.2k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

  • Reviewable Design Doc

    u-ichi/reviewable-html-workbench

    要求・設計・アーキテクチャ・未決事項を整理し、レビュー可能な設計資料HTMLを作りたい時に使う。Use this skill to structure requirements, design, architecture, alternatives, decisions, and unresolved issues into a review-ready HTML design document.

    298 GitHub starsUsed in 1 repo~8.6k tokens
    DevelopmentAuto-check passed

  • Write Vibe ADR

    mistralai/mistral-vibe

    Official

    Creates or updates concise Architecture Decision Records for the Mistral Vibe CLI and registers each one in the AGENTS.md decisions table.

    5.1k GitHub stars~942 tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Okf Frontmatter

    longsizhuo/openInvest

    Maintain openInvest's docs (docs/wiki chapters + docs/wiki/adr) under Google's Open Knowledge Format (OKF).

    108 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed

More from jonathan-vella/apex

All 39 skills in this repo

  • Apex Azure Diagnostics

    jonathan-vella/apex

    WORKFLOW SKILL — Debug Azure production issues: Container Apps, Functions, App Service, AKS, VMs and messaging, with KQL log analysis.

    217 GitHub stars~2.1k tokensUpdated today
    Auto-check passed

  • Apex Azure Governance Discovery

    jonathan-vella/apex

    ANALYSIS SKILL — Azure Policy discovery: effective assignments (incl.

    217 GitHub stars~2.1k tokensUpdated today
    Auto-check passed

  • Apex Context Management

    jonathan-vella/apex

    UTILITY SKILL — Two-mode context-window management. An agent skill from jonathan-vella/apex.

    217 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Apex Python Diagrams

    jonathan-vella/apex

    UTILITY SKILL — Python diagram generation for Azure architectures, WAF/cost/compliance charts, ERDs, swimlanes, timelines, and wireframes.

    217 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Apex Terraform Search Import

    jonathan-vella/apex

    WORKFLOW SKILL — Manual-only discovery and import of existing Azure resources into Terraform management.

    217 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Apex Vendor Prompting

    jonathan-vella/apex

    ANALYSIS SKILL — Manual-only audit of Anthropic Claude Opus 5.5 / Sonnet 5.5 and OpenAI GPT-6 / GPT-5.6 prompting guidance and APEX conventions.

    217 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Apex Azure Adr

What does Apex Azure Adr do?

ANALYSIS SKILL — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences. Apex Azure Adr is an agent skill from jonathan-vella/apex. ANALYSIS SKILL — Creates Azure Architecture Decision Records (ADRs) with WAF pillar mapping, alternatives, and consequences.

When should I use Apex Azure Adr?

Apex Azure Adr fits situations like: : IaC code (06b/06t agents); diagrams (apex-python-diagrams); cost estimates (cost-estimate-subagent).

How do I install Apex Azure Adr in Claude Code?

Run `npx skills add jonathan-vella/apex --skill apex-azure-adr -a claude-code`. Or copy the skill folder (.github/skills/apex-azure-adr in jonathan-vella/apex) into .claude/skills/apex-azure-adr in your project. Claude Code loads it when a task matches its description.

How do I install Apex Azure Adr in Codex?

Run `npx skills add jonathan-vella/apex --skill apex-azure-adr -a codex`. Or copy the skill folder (.github/skills/apex-azure-adr in jonathan-vella/apex) into .agents/skills/apex-azure-adr in your project. Codex loads it when a task matches its description.

Can I use Apex Azure Adr in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jonathan-vella/apex --skill apex-azure-adr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apex-azure-adr, .gemini/skills/apex-azure-adr, .github/skills/apex-azure-adr and .opencode/skills/apex-azure-adr in your project.

What does Apex Azure Adr need to run?

SKILL.md names no scripts, command-line tools or credentials: Apex Azure Adr is instructions for the agent only. Compatibility (from SKILL.md): Works with Claude Code, GitHub Copilot, VS Code, and any Agent Skills compatible tool; no external dependencies required..

Does Apex Azure Adr access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Apex Azure Adr safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apex Azure Adr use?

Apex Azure Adr is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apex Azure Adr use?

About 860 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Apex Azure Adr?

Skills that share tags, products or a category with Apex Azure Adr: Design Doc Mermaid (SpillwaveSolutions/design-doc-mermaid, 176 stars), Create Vibe Feature (mistralai/mistral-vibe, 5.1k stars), Docs (brickbots/PiFinder, 250 stars) and Reviewable Design Doc (u-ichi/reviewable-html-workbench, 298 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apex Azure Adr?

jonathan-vella (a GitHub user) maintains it in jonathan-vella/apex, which has 217 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 10, 2026.

Source: jonathan-vella/apex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.