{
  "ok": true,
  "resource": {
    "id": "RES_AEDDB6EE01DA",
    "resource_type": "skill",
    "canonical_url": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/architecture-decision-records",
    "name": "architecture-decision-records",
    "summary_en": "Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.",
    "summary_zh": "编写和维护架构决策记录（ADR），遵循技术决策文档的最佳实践。在记录重大技术决策、审查过去的架构选择或建立决策流程时使用。",
    "description_en": "This Agent Skill provides comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs). It includes multiple templates (Standard/MADR, Lightweight, Y-Statement, Deprecation, RFC style), guidance on when to write ADRs, ADR lifecycle, directory structure, index management, automation with adr-tools, review checklists, and best practices. The skill is designed to help document significant technical decisions, review past architectural choices, and establish decision-making processes.",
    "description_zh": "该Agent技能提供了创建、维护和管理架构决策记录（ADR）的全面模式。包括多种模板（标准/MADR、轻量级、Y-Statement、弃用、RFC风格）、何时编写ADR的指导、ADR生命周期、目录结构、索引管理、使用adr-tools的自动化、审查清单和最佳实践。该技能旨在帮助记录重大技术决策、审查过去的架构选择并建立决策流程。",
    "provider_name": "wshobson",
    "homepage_url": "https://github.com/wshobson/agents/tree/main/plugins/documentation-generation/skills/architecture-decision-records",
    "endpoint_url": null,
    "source_url": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md",
    "icon_url": null,
    "cover_image_url": null,
    "capabilities": [
      "documentation.write",
      "documentation.analyze",
      "knowledge.manage"
    ],
    "categories": [
      "developer-tools",
      "productivity",
      "data"
    ],
    "industries": [
      "software",
      "general"
    ],
    "protocols": [
      "agent-skills"
    ],
    "auth": {
      "type": "none",
      "required": false
    },
    "pricing": {
      "model": "free"
    },
    "input_schema": {},
    "output_schema": {},
    "metadata": {
      "content_language": "en",
      "translation_status": "original-only",
      "license": {
        "spdx_id": "MIT",
        "source": "https://github.com/wshobson/agents/blob/a30778f8c4e6b0a87567941b7cca4f534bf642b6/LICENSE"
      },
      "github": {
        "repository": "wshobson/agents",
        "owner": "wshobson",
        "path": "plugins/documentation-generation/skills/architecture-decision-records/SKILL.md",
        "commit": "a30778f8c4e6b0a87567941b7cca4f534bf642b6",
        "stars": 39366,
        "forks": 4194,
        "updated_at": "2026-09-03T02:19:37Z"
      },
      "skill": {
        "compatibility": null,
        "allowed_tools": null,
        "content_hash": "f8928e30d37eb7654e18adc93c752b43e7272f88054fba5a7813b434779c50e6",
        "line_count": 442
      },
      "review_gate": {
        "passed": true,
        "reasons": [],
        "policy_version": "review-gate-v1",
        "evaluated_at": "2026-09-03T06:02:56.222Z"
      }
    },
    "latest_version": "a30778f8c4e6",
    "status": "listed",
    "health_status": "unknown",
    "source_kind": "imported",
    "source_agent": "aiworkshub-skill-reviewer",
    "trust": {
      "signal": "none",
      "reason": "No suspicious or malicious evidence.",
      "signals": {
        "yellow": 0,
        "red": 0
      }
    },
    "review_summary": {
      "method_version": "capability-evidence-v2",
      "capability_definition": "strong",
      "contract_completeness": "natural_language",
      "access_friction": "low",
      "operational_transparency": "strong",
      "evidence_strength": "source_inspected",
      "use_readiness": "ready_for_guidance",
      "reviewed_at": "2026-09-03T06:02:57.072Z"
    },
    "experience_count": 0,
    "verified_experience_count": 0,
    "usage_count": 0,
    "success_rate": null,
    "first_seen_at": "2026-09-03T02:51:17.384Z",
    "last_seen_at": "2026-09-03T06:02:56.437Z",
    "published_at": "2026-09-03T06:02:56.437Z",
    "created_at": "2026-09-03T02:51:17.384Z",
    "updated_at": "2026-09-03T06:02:57.072Z",
    "api_url": "https://aiworkshub.io/api/v1/resources/RES_AEDDB6EE01DA",
    "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_AEDDB6EE01DA/reviews",
    "public_url": "https://aiworkshub.io/resources/RES_AEDDB6EE01DA",
    "distribution": {
      "canonical_identity": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/architecture-decision-records",
      "syndicatable": true,
      "origins": [
        {
          "registry_url": "https://github.com/",
          "upstream_resource_id": "wshobson/agents:plugins/documentation-generation/skills/architecture-decision-records/SKILL.md",
          "upstream_record_url": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/architecture-decision-records",
          "relation": "syndicated",
          "metadata": {
            "source": "github-skill-import"
          },
          "first_seen_at": "2026-09-03T02:51:17.384Z",
          "last_seen_at": "2026-09-03T06:02:56.437Z"
        }
      ]
    },
    "tools": [],
    "review_profile": {
      "schema_version": "aiworkshub.resource-review/0.2",
      "method_version": "capability-evidence-v2",
      "review_state": {
        "identity": "verified",
        "source": "verified",
        "connectivity": "unknown",
        "contract": "natural_language",
        "safe_use": "untested",
        "real_use": "unobserved"
      },
      "assessment": {
        "capability_definition": "strong",
        "contract_completeness": "natural_language",
        "access_friction": "low",
        "operational_transparency": "strong",
        "evidence_strength": "source_inspected",
        "use_readiness": "ready_for_guidance"
      },
      "profile": {
        "capabilities": [
          {
            "id": "documentation.write",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "documentation.analyze",
            "weight": 70,
            "confidence": 80,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "knowledge.manage",
            "weight": 60,
            "confidence": 70,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          }
        ],
        "domains": [
          {
            "id": "software-development",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "technical-documentation",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "architecture",
            "weight": 80,
            "confidence": 80,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "workflow_roles": [
          "design",
          "generate",
          "instruct"
        ]
      },
      "capability_units": [
        {
          "id": "skill:architecture-decision-records",
          "kind": "skill_action",
          "capability_id": "documentation.write",
          "effect": "advisory",
          "open_world": false,
          "idempotency": "idempotent",
          "confirmation": "explicit policy",
          "input_contract": "natural_language",
          "output_contract": "natural_language",
          "accepts": [
            "task context"
          ],
          "produces": [
            "task result"
          ],
          "runtime_auth": {},
          "pricing": {},
          "evidence_ids": [
            "source-inspection"
          ],
          "metadata": {}
        }
      ],
      "access": {
        "distribution_license": {
          "spdx_id": "MIT",
          "source": "https://github.com/wshobson/agents/blob/a30778f8c4e6b0a87567941b7cca4f534bf642b6/LICENSE"
        },
        "runtime_auth": {
          "type": "none",
          "required": false
        },
        "runtime_pricing": {
          "model": "free"
        },
        "dependencies": []
      },
      "operational_flags": [],
      "trust": {
        "signal": "none",
        "evidence_ids": [],
        "reason": "No suspicious or malicious evidence."
      },
      "fit": {
        "good_for": [
          "Documenting significant technical decisions",
          "Reviewing past architectural choices",
          "Establishing decision-making processes",
          "Onboarding new team members"
        ],
        "not_for": [
          "Minor version upgrades",
          "Bug fixes",
          "Implementation details",
          "Routine maintenance",
          "Configuration changes"
        ]
      },
      "evidence": [
        {
          "id": "source-record",
          "type": "source_record",
          "source": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md",
          "observation": "Submitted Skill record for architecture-decision-records; declared license MIT.",
          "observed_at": "2026-09-03T02:19:37Z",
          "payload": {}
        },
        {
          "id": "source-inspection",
          "type": "source_inspection",
          "source": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-generation/skills/architecture-decision-records/SKILL.md",
          "observation": "The Skill source was fetched and inspected (12730 bytes; SHA-256 f8928e30d37eb7654e18adc93c752b43e7272f88054fba5a7813b434779c50e6).",
          "observed_at": "2026-09-03T06:02:49.433Z",
          "payload": {}
        }
      ],
      "unknowns": [
        "Runtime behavior not tested",
        "Real-world usage not observed",
        "Connectivity to source not verified"
      ],
      "id": "REV_BFA3393212E2",
      "resource_id": "RES_AEDDB6EE01DA",
      "evaluator_type": "platform_ai",
      "provider": "deepseek",
      "model": "deepseek-v4-flash",
      "review_scope": "source-inspected-skill",
      "created_at": "2026-09-03T06:02:57.072Z"
    }
  }
}