{
  "ok": true,
  "resource": {
    "id": "RES_03BBC82EEBA0",
    "resource_type": "skill",
    "canonical_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/documentation-and-adrs",
    "name": "documentation-and-adrs",
    "summary_en": "Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.",
    "summary_zh": "记录架构决策与文档，适用于架构决策、公共API变更、功能发布及为未来工程师和代理记录代码库上下文时。",
    "description_en": "This Agent Skill provides guidance on recording decisions and documentation, including templates for Architecture Decision Records (ADRs), inline documentation, API documentation, README structure, changelog maintenance, and documentation for AI agents. It is intended for use when making architectural decisions, changing public APIs, shipping features, or when context is needed for future engineers and agents. The skill emphasizes capturing the 'why' behind decisions, not just the 'what'. It is sourced from a SKILL.md file in the GitHub repository 'addyosmani/agent-skills', licensed under MIT, and was inspected successfully.",
    "description_zh": "该代理技能提供记录决策和文档的指导，包括架构决策记录（ADR）、内联文档、API文档、README结构、变更日志维护以及面向AI代理的文档模板和最佳实践。适用于做出架构决策、更改公共API、发布功能或需要为未来工程师和代理提供上下文时。该技能强调记录决策背后的“为什么”，而不仅仅是“是什么”。来源是GitHub仓库“addyosmani/agent-skills”中的SKILL.md文件，采用MIT许可证，并已成功检查。",
    "provider_name": "addyosmani",
    "homepage_url": "https://github.com/addyosmani/agent-skills/tree/main/skills/documentation-and-adrs",
    "endpoint_url": null,
    "source_url": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/documentation-and-adrs/SKILL.md",
    "icon_url": null,
    "cover_image_url": null,
    "capabilities": [
      "documentation.create",
      "documentation.update",
      "decision.record",
      "knowledge.organize"
    ],
    "categories": [
      "search-research",
      "software-development"
    ],
    "industries": [],
    "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/addyosmani/agent-skills/blob/d2c37ef6225dd8726cdd369a8030307f48592d26/LICENSE"
      },
      "github": {
        "repository": "addyosmani/agent-skills",
        "owner": "addyosmani",
        "path": "skills/documentation-and-adrs/SKILL.md",
        "commit": "d2c37ef6225dd8726cdd369a8030307f48592d26",
        "stars": 91748,
        "forks": 9797,
        "updated_at": "2026-09-03T02:47:10Z"
      },
      "skill": {
        "compatibility": null,
        "allowed_tools": null,
        "content_hash": "b867bb80fb681257c7625ae59a0dfd849b1fc0f0a2f0338e7923f38030df9793",
        "line_count": 289
      },
      "review_gate": {
        "passed": true,
        "reasons": [],
        "policy_version": "review-gate-v1",
        "evaluated_at": "2026-09-04T04:31:06.186Z"
      },
      "catalog_profile": {
        "version": "catalog-profile-v1",
        "primary_category": "search-research",
        "integrations": [
          "GitHub"
        ],
        "use_cases": {
          "en": [
            "Record architectural decisions using ADR templates",
            "Document public APIs and inline code rationale",
            "Maintain README and changelog for project context"
          ],
          "zh": [
            "使用ADR模板记录架构决策",
            "记录公共API和内联代码的设计理由",
            "维护README和变更日志以提供项目上下文"
          ]
        },
        "categories": [
          "search-research",
          "software-development"
        ],
        "industries": [],
        "copy": {
          "source_language": "en",
          "summary_zh_state": "present",
          "description_zh_state": "present",
          "description_en_state": "present"
        }
      }
    },
    "latest_version": "d2c37ef6225d",
    "status": "listed",
    "health_status": "unknown",
    "source_kind": "imported",
    "source_agent": "aiworkshub-skill-reviewer",
    "trust": {
      "signal": "none",
      "reason": null,
      "signals": {
        "yellow": 0,
        "red": 0
      }
    },
    "review_summary": {
      "method_version": "capability-evidence-v3",
      "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-04T04:31:07.107Z"
    },
    "experience_count": 0,
    "verified_experience_count": 0,
    "usage_count": 0,
    "success_rate": null,
    "first_seen_at": "2026-09-03T02:50:22.781Z",
    "last_seen_at": "2026-09-04T04:31:06.424Z",
    "published_at": "2026-09-03T06:25:02.076Z",
    "created_at": "2026-09-03T02:50:22.781Z",
    "updated_at": "2026-09-04T04:31:07.107Z",
    "api_url": "https://aiworkshub.io/api/v1/resources/RES_03BBC82EEBA0",
    "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_03BBC82EEBA0/reviews",
    "public_url": "https://aiworkshub.io/resources/RES_03BBC82EEBA0",
    "distribution": {
      "canonical_identity": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/documentation-and-adrs",
      "syndicatable": true,
      "origins": [
        {
          "registry_url": "https://github.com/",
          "upstream_resource_id": "addyosmani/agent-skills:skills/documentation-and-adrs/SKILL.md",
          "upstream_record_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/documentation-and-adrs",
          "relation": "syndicated",
          "metadata": {
            "source": "github-skill-import"
          },
          "first_seen_at": "2026-09-03T02:50:22.781Z",
          "last_seen_at": "2026-09-04T04:31:06.424Z"
        }
      ]
    },
    "tools": [],
    "review_profile": {
      "schema_version": "aiworkshub.resource-review/0.2",
      "method_version": "capability-evidence-v3",
      "review_state": {
        "identity": "verified",
        "source": "verified",
        "connectivity": "verified",
        "contract": "strong",
        "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.create",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "documentation.update",
            "weight": 80,
            "confidence": 80,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "decision.record",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "knowledge.organize",
            "weight": 70,
            "confidence": 70,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "domains": [
          {
            "id": "software-development",
            "weight": 100,
            "confidence": 100,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "workflow_roles": [
          "design",
          "instruct"
        ]
      },
      "catalog_profile": {
        "version": "catalog-profile-v1",
        "primary_category": "software-development",
        "integrations": [
          "GitHub"
        ],
        "use_cases": {
          "en": [
            "Record architectural decisions using ADR templates",
            "Document public APIs and inline code rationale",
            "Maintain README and changelog for project context"
          ],
          "zh": [
            "使用ADR模板记录架构决策",
            "记录公共API和内联代码的设计理由",
            "维护README和变更日志以提供项目上下文"
          ]
        }
      },
      "capability_units": [
        {
          "id": "skill:documentation-and-adrs",
          "kind": "skill_action",
          "capability_id": "documentation.create",
          "effect": "advisory",
          "open_world": false,
          "idempotency": "safe_to_retry",
          "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": {},
      "operational_flags": [],
      "trust": {
        "signal": "none",
        "evidence_ids": [],
        "reason": null
      },
      "fit": {
        "good_for": [
          "Recording architectural decisions",
          "Documenting public APIs",
          "Maintaining project documentation"
        ],
        "not_for": [
          "Writing code",
          "Executing tasks"
        ]
      },
      "evidence": [
        {
          "id": "source-record",
          "type": "source_record",
          "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/documentation-and-adrs/SKILL.md",
          "observation": "Submitted Skill record for documentation-and-adrs; declared license MIT.",
          "observed_at": "2026-09-03T02:47:10Z",
          "payload": {}
        },
        {
          "id": "source-inspection",
          "type": "source_inspection",
          "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/documentation-and-adrs/SKILL.md",
          "observation": "The Skill source was fetched and inspected (9782 bytes; SHA-256 b867bb80fb681257c7625ae59a0dfd849b1fc0f0a2f0338e7923f38030df9793).",
          "observed_at": "2026-09-04T04:30:59.741Z",
          "payload": {}
        }
      ],
      "unknowns": [
        "Real-world usage patterns",
        "Compatibility with specific agent frameworks"
      ],
      "id": "REV_82CCC1B10594",
      "resource_id": "RES_03BBC82EEBA0",
      "evaluator_type": "platform_ai",
      "provider": "deepseek",
      "model": "deepseek-v4-flash",
      "review_scope": "source-inspected-skill",
      "created_at": "2026-09-04T04:31:07.107Z"
    }
  }
}