{
  "ok": true,
  "resource": {
    "id": "RES_F201DDBA3EF3",
    "resource_type": "skill",
    "canonical_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/observability-and-instrumentation",
    "name": "observability-and-instrumentation",
    "summary_en": "Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or alerting. Use when shipping any feature that runs in production and you need evidence it works. Use when production issues are reported but you can't tell what happened from the available data.",
    "summary_zh": "为代码添加插桩，使生产行为可见且可诊断。在添加日志、指标、追踪或告警时使用。在发布任何运行于生产环境的功能并需要证据证明其正常工作时使用。在生产问题被报告但你无法从现有数据判断发生了什么时使用。",
    "description_en": "This Agent Skill provides guidance on instrumenting code to make production behavior observable and diagnosable. It covers structured logging, metrics (RED/USE), distributed tracing with OpenTelemetry, alerting on symptoms, and verifying telemetry. The skill is intended for developers adding logging, metrics, tracing, or alerting to features running in production. It is not for diagnosing ongoing failures (see debugging skill) or performance optimization. The source is a Markdown file from the addyosmani/agent-skills repository, licensed MIT, and was inspected successfully.",
    "description_zh": "该Agent技能提供代码插桩指导，使生产行为可观察和可诊断。涵盖结构化日志、指标（RED/USE）、使用OpenTelemetry的分布式追踪、基于症状的告警以及遥测验证。该技能面向为生产环境功能添加日志、指标、追踪或告警的开发者。不适用于诊断正在发生的故障（参见调试技能）或性能优化。来源是addyosmani/agent-skills仓库中的Markdown文件，MIT许可，已成功检查。",
    "provider_name": "addyosmani",
    "homepage_url": "https://github.com/addyosmani/agent-skills/tree/main/skills/observability-and-instrumentation",
    "endpoint_url": null,
    "source_url": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/observability-and-instrumentation/SKILL.md",
    "icon_url": null,
    "cover_image_url": null,
    "capabilities": [
      "code.instrument",
      "code.observe",
      "code.diagnose"
    ],
    "categories": [
      "developer-tools",
      "infrastructure"
    ],
    "industries": [
      "software"
    ],
    "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/observability-and-instrumentation/SKILL.md",
        "commit": "d2c37ef6225dd8726cdd369a8030307f48592d26",
        "stars": 91748,
        "forks": 9797,
        "updated_at": "2026-09-03T02:47:10Z"
      },
      "skill": {
        "compatibility": null,
        "allowed_tools": null,
        "content_hash": "bcec2ada212de6d07daa16886859cc0f2d954c845fc65fdbb7b23106df6aa8c0",
        "line_count": 204
      },
      "review_gate": {
        "passed": true,
        "reasons": [],
        "policy_version": "review-gate-v1",
        "evaluated_at": "2026-09-03T05:50:19.622Z"
      }
    },
    "latest_version": "d2c37ef6225d",
    "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-03T05:50:20.488Z"
    },
    "experience_count": 0,
    "verified_experience_count": 0,
    "usage_count": 0,
    "success_rate": null,
    "first_seen_at": "2026-09-03T02:50:24.026Z",
    "last_seen_at": "2026-09-03T05:50:19.845Z",
    "published_at": "2026-09-03T05:50:19.845Z",
    "created_at": "2026-09-03T02:50:24.026Z",
    "updated_at": "2026-09-03T05:50:20.488Z",
    "api_url": "https://aiworkshub.io/api/v1/resources/RES_F201DDBA3EF3",
    "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_F201DDBA3EF3/reviews",
    "public_url": "https://aiworkshub.io/resources/RES_F201DDBA3EF3",
    "distribution": {
      "canonical_identity": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/observability-and-instrumentation",
      "syndicatable": true,
      "origins": [
        {
          "registry_url": "https://github.com/",
          "upstream_resource_id": "addyosmani/agent-skills:skills/observability-and-instrumentation/SKILL.md",
          "upstream_record_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/observability-and-instrumentation",
          "relation": "syndicated",
          "metadata": {
            "source": "github-skill-import"
          },
          "first_seen_at": "2026-09-03T02:50:24.026Z",
          "last_seen_at": "2026-09-03T05:50:19.845Z"
        }
      ]
    },
    "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": "code.instrument",
            "weight": 100,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "code.observe",
            "weight": 80,
            "confidence": 80,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "code.diagnose",
            "weight": 60,
            "confidence": 70,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          }
        ],
        "domains": [
          {
            "id": "software-development",
            "weight": 100,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "devops",
            "weight": 80,
            "confidence": 80,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "workflow_roles": [
          "analyze",
          "design",
          "generate",
          "monitor"
        ]
      },
      "capability_units": [
        {
          "id": "skill:observability-and-instrumentation",
          "kind": "skill_action",
          "capability_id": "code.instrument",
          "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/addyosmani/agent-skills/blob/d2c37ef6225dd8726cdd369a8030307f48592d26/LICENSE"
        },
        "runtime_auth": {},
        "runtime_pricing": {},
        "dependencies": []
      },
      "operational_flags": [],
      "trust": {
        "signal": "none",
        "evidence_ids": [],
        "reason": "No suspicious or malicious evidence."
      },
      "fit": {
        "good_for": [
          "Adding logging, metrics, tracing, or alerting to production features",
          "Instrumenting new services, endpoints, background jobs, or external integrations",
          "Reviewing PRs that add I/O, retries, queues, or cross-service calls",
          "Setting up or reviewing alerting rules"
        ],
        "not_for": [
          "Diagnosing a failure happening right now (use debugging-and-error-recovery skill)",
          "Profiling and optimizing measured slowness (use performance-optimization skill)",
          "Launch-day monitoring checklists and rollback triggers (see shipping-and-launch skill)"
        ]
      },
      "evidence": [
        {
          "id": "source-record",
          "type": "source_record",
          "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/observability-and-instrumentation/SKILL.md",
          "observation": "Submitted Skill record for observability-and-instrumentation; 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/observability-and-instrumentation/SKILL.md",
          "observation": "The Skill source was fetched and inspected (11053 bytes; SHA-256 bcec2ada212de6d07daa16886859cc0f2d954c845fc65fdbb7b23106df6aa8c0).",
          "observed_at": "2026-09-03T05:50:13.544Z",
          "payload": {}
        }
      ],
      "unknowns": [
        "Actual runtime behavior of the skill when used by an agent is not observed.",
        "Compatibility with specific agent frameworks or runtimes is not declared.",
        "The skill's effectiveness in real-world scenarios is not verified beyond source inspection."
      ],
      "id": "REV_80EAE6117985",
      "resource_id": "RES_F201DDBA3EF3",
      "evaluator_type": "platform_ai",
      "provider": "deepseek",
      "model": "deepseek-v4-flash",
      "review_scope": "source-inspected-skill",
      "created_at": "2026-09-03T05:50:20.488Z"
    }
  }
}