{ "ok": true, "resource": { "id": "RES_897750D61F49", "resource_type": "skill", "canonical_url": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-standards/skills/hads", "name": "hads", "summary_en": "Use when writing technical documentation that needs to be readable by both humans and AI models, converting existing docs to HADS format, validating a HADS document, or optimizing documentation for token-efficient AI consumption.", "summary_zh": "在编写需要人类和AI模型都能阅读的技术文档时使用；将现有文档转换为HADS格式；验证HADS文档；或优化文档以实现token高效的AI消费。", "description_en": "This skill provides instructions for reading, generating, and validating documents conforming to the Human-AI Document Standard (HADS). It defines four block types ([SPEC], [NOTE], [BUG], [?]), required document structure, and validation rules. The skill is intended for use when writing technical documentation that is readable by both humans and AI models, converting existing docs to HADS format, validating HADS documents, or optimizing documentation for token-efficient AI consumption.", "description_zh": "该技能提供了阅读、生成和验证符合人机文档标准（HADS）的文档的说明。它定义了四种块类型（[SPEC]、[NOTE]、[BUG]、[?]）、必需的文档结构和验证规则。该技能适用于编写人类和AI模型都能阅读的技术文档、将现有文档转换为HADS格式、验证HADS文档或优化文档以实现token高效的AI消费。", "provider_name": "wshobson", "homepage_url": "https://github.com/wshobson/agents/tree/main/plugins/documentation-standards/skills/hads", "endpoint_url": null, "source_url": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-standards/skills/hads/SKILL.md", "icon_url": null, "cover_image_url": null, "capabilities": [ "document.generate", "document.transform", "document.validate", "document.analyze" ], "categories": [ "developer-tools", "productivity", "data", "communication" ], "industries": [ "software", "media", "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-standards/skills/hads/SKILL.md", "commit": "a30778f8c4e6b0a87567941b7cca4f534bf642b6", "stars": 39366, "forks": 4194, "updated_at": "2026-09-03T02:19:37Z" }, "skill": { "compatibility": null, "allowed_tools": null, "content_hash": "02e8fab07e66768e32eb5c20afccd00c2c1ed52d142ec533fbe608a0037edba1", "line_count": 190 }, "review_gate": { "passed": true, "reasons": [], "policy_version": "review-gate-v1", "evaluated_at": "2026-09-03T06:06:34.751Z" } }, "latest_version": "a30778f8c4e6", "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-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:06:35.738Z" }, "experience_count": 0, "verified_experience_count": 0, "usage_count": 0, "success_rate": null, "first_seen_at": "2026-09-03T02:51:18.383Z", "last_seen_at": "2026-09-03T06:06:35.016Z", "published_at": "2026-09-03T06:06:35.016Z", "created_at": "2026-09-03T02:51:18.383Z", "updated_at": "2026-09-03T06:06:35.738Z", "api_url": "https://aiworkshub.io/api/v1/resources/RES_897750D61F49", "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_897750D61F49/reviews", "public_url": "https://aiworkshub.io/resources/RES_897750D61F49", "distribution": { "canonical_identity": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-standards/skills/hads", "syndicatable": true, "origins": [ { "registry_url": "https://github.com/", "upstream_resource_id": "wshobson/agents:plugins/documentation-standards/skills/hads/SKILL.md", "upstream_record_url": "https://github.com/wshobson/agents/tree/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-standards/skills/hads", "relation": "syndicated", "metadata": { "source": "github-skill-import" }, "first_seen_at": "2026-09-03T02:51:18.383Z", "last_seen_at": "2026-09-03T06:06:35.016Z" } ] }, "tools": [], "review_profile": { "schema_version": "aiworkshub.resource-review/0.2", "method_version": "capability-evidence-v2", "review_state": { "identity": "verified", "source": "verified", "connectivity": "unknown", "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": "document.generate", "weight": 90, "confidence": 90, "evidence_ids": [ "source-record", "source-inspection" ] }, { "id": "document.transform", "weight": 80, "confidence": 90, "evidence_ids": [ "source-record", "source-inspection" ] }, { "id": "document.validate", "weight": 80, "confidence": 90, "evidence_ids": [ "source-record", "source-inspection" ] }, { "id": "document.analyze", "weight": 70, "confidence": 90, "evidence_ids": [ "source-record", "source-inspection" ] } ], "domains": [ { "id": "software-development", "weight": 90, "confidence": 90, "evidence_ids": [ "source-record" ] }, { "id": "document-processing", "weight": 90, "confidence": 90, "evidence_ids": [ "source-record" ] }, { "id": "writing", "weight": 80, "confidence": 90, "evidence_ids": [ "source-record" ] } ], "workflow_roles": [ "generate", "transform", "analyze", "instruct" ] }, "capability_units": [ { "id": "skill:hads", "kind": "skill_action", "capability_id": "document.generate", "effect": "unknown", "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": {}, "runtime_pricing": {}, "dependencies": [] }, "operational_flags": [], "trust": { "signal": "none", "evidence_ids": [], "reason": null }, "fit": { "good_for": [ "Writing technical documentation in HADS format", "Converting existing documentation to HADS", "Validating HADS documents", "Summarizing HADS documents for AI consumption" ], "not_for": [ "Non-technical documentation", "Formats other than Markdown" ] }, "evidence": [ { "id": "source-record", "type": "source_record", "source": "https://raw.githubusercontent.com/wshobson/agents/a30778f8c4e6b0a87567941b7cca4f534bf642b6/plugins/documentation-standards/skills/hads/SKILL.md", "observation": "Submitted Skill record for hads; 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-standards/skills/hads/SKILL.md", "observation": "The Skill source was fetched and inspected (6104 bytes; SHA-256 02e8fab07e66768e32eb5c20afccd00c2c1ed52d142ec533fbe608a0037edba1).", "observed_at": "2026-09-03T06:06:27.604Z", "payload": {} } ], "unknowns": [ "Actual runtime behavior not tested", "Real-world usage not observed", "Connectivity to source not verified" ], "id": "REV_34EA779A4DF0", "resource_id": "RES_897750D61F49", "evaluator_type": "platform_ai", "provider": "deepseek", "model": "deepseek-v4-flash", "review_scope": "source-inspected-skill", "created_at": "2026-09-03T06:06:35.738Z" } } }