Skip to content
TrustedSkillsbeta
Back to all skills

Architecture Decision Records

Listed
sickn33·vlatest·backend·MIT

This skill generates detailed Architecture Decision Records (ADRs) to document design choices, fostering clarity and collaboration within projects.

Repository

Install on your platform

Showing Claude Code. One command installs this skill into any of the agents below.

  1. 1

    Run this in your project

    terminal
    $ npx skills add sickn33/agentic-awesome-skills --skill architecture-decision-records -a claude-code

  2. Uses the open-source skills CLI and needs Node.js. Add -g to install it for your user instead of this project.

What we know about this skill

Publisher

sickn33

Taken from the source listing. We haven't verified who controls this account.

Install target

Live repository

Not pinned. Installing fetches whatever the repository holds at the time you run the command.

No human has reviewed this code. The checks below are a static scan of the files at one commit — nobody has run this skill or judged whether it works. A skill runs with whatever access you give your agent, so read the source before you install it.

Automated safety checks

scanned

This skill failed 1 of 6 checks. A failure is not proof of bad intent; it means something in the code needs a human to look at it before you run it.

  • Declares what it does: failed

    No SKILL.md was found in the skill's directory.

    SKILL.md exists, its frontmatter parses, and it declares a name and a description.

  • No undeclared network calls: passed

    Makes no network calls.

    Every host the skill dials — from its scripts, its config endpoints or the commands it tells the agent to run — is either well-known package and API infrastructure or declared in its own frontmatter. Links in documentation are not counted.

  • No obfuscated payloads: passed

    No encoded or obfuscated payloads.

    No base64, hex or compressed blob is decoded and then executed, and no encoded shell commands.

  • No credential access: passed

    Reads no keys, tokens, keychains or credential files.

    Neither the code nor the SKILL.md instructions read SSH keys, cloud credentials, keychains, token stores, browser cookie databases or dotfiles that hold secrets.

  • No pipe-to-shell installers: passed

    No pipe-to-shell or download-and-run installers.

    No `curl … | sh` pattern, in the code or in the instructions, that runs code fetched at run time.

  • Pinned to a commit: passed

    Scanned sickn33/antigravity-awesome-skills at 5a4cdd9df8.

    The exact upstream commit SHA that was scanned is recorded, so the result refers to specific bytes.

Commit
5a4cdd9df8
Manifest
skills/architecture-decision-records/SKILL.md
Scanned
0 files
Copies in repo
3 — all of them scanned
This is a static scan, not a review. It reads the skill's files; it does not run them, and it cannot tell you whether the skill is any good or whether the code does what its description says. A skill runs with whatever access you give your agent.
What each check looks for →

About this skill

What it does

This skill enables AI agents to generate, manage, and retrieve Architecture Decision Records (ADRs) to document significant technical choices made during software development. It ensures that the rationale behind decisions is preserved alongside the implementation details for future reference.

When to use it

  • Documenting a shift from monolithic architecture to microservices with clear justification.
  • Recording security protocol changes required by new compliance regulations.
  • Capturing trade-offs between performance optimization and code maintainability.
  • Onboarding new team members by providing context on why specific legacy patterns exist.

Key capabilities

  • Generates structured ADRs containing the decision status, context, consequences, and implementation details.
  • Maintains a centralized repository of architectural history within the project workspace.
  • Supports versioning and updating of decisions as requirements evolve over time.
  • Formats output to align with standard ADR templates for consistency.

Example prompts

  • "Create an Architecture Decision Record for migrating our database from SQL to NoSQL, including the pros and cons we considered."
  • "Review our existing ADRs and suggest updates based on recent feedback regarding system scalability."
  • "Generate a template for documenting a new authentication strategy and fill it with placeholder details for my team to complete."

Tips & gotchas

Ensure you provide sufficient context about current constraints and business goals when requesting an ADR, as the skill relies on this input to generate accurate rationales. While the tool structures the documentation effectively, human review is still recommended to validate technical feasibility before finalizing decisions.