Skills as Institutional Knowledge Architecture

Skills as Institutional Knowledge Architecture An architecture diagram generated by Archify. Policy Owner · Security & Architecture Team · Architecture component Policy Owner Security & Architecture Team SKILL.md · Prompt & operational rules · Skill Package (.claude/skills/<name>/) · auto-trigger SKILL.md Prompt & operational rules auto-trigger Semantic Description · YAML frontmatter metadata · Skill Package (.claude/skills/<name>/) Semantic Description YAML frontmatter metadata scripts/ Directory · Executable check scripts · Skill Package (.claude/skills/<name>/) scripts/ Directory Executable check scripts references/ Directory · Specifications & schemas · Skill Package (.claude/skills/<name>/) references/ Directory Specifications & schemas Skill Auto-Trigger Router · Matches user prompt & context · Agent Execution & Enforcement Lane · zero manual invoke Skill Auto-Trigger Router Matches user prompt & context zero manual invoke Active Agent Session · Advisory policy execution · Agent Execution & Enforcement Lane · in-flight advice Active Agent Session Advisory policy execution in-flight advice Deterministic Build Hook · PreToolUse interceptor & linter · Agent Execution & Enforcement Lane · hard blocker Deterministic Build Hook PreToolUse interceptor & linter hard blocker PR Review Loop · Policy Owner approval & audit · Architecture component · audit trail PR Review Loop Policy Owner approval & audit audit trail Skill Package (.claude/skills/<name>/) Agent Execution & Enforcement Lane Legend Frontend Backend Cloud Security External

Cấu trúc Skill Package

  • • SKILL.md định nghĩa mô tả semantic trong YAML frontmatter để tự động kích hoạt
  • • Thư mục scripts/ chạy các Commands deterministic, references/ lưu tài liệu kỹ thuật

Advisory Control vs Deterministic Hook

  • • Skill cung cấp advisory control giúp Agent viết code chuẩn ngay từ đầu
  • • Build hooks và PR Review đóng vai trò deterministic control ngăn chặn triệt để vi phạm