Central repository for reusable AI Skills, Skill Registry, and safe references governed by AI-Building-PromptStandard.
Overview
Central repository for reusable AI Skills, Skill discovery governance, compatibility control, version retention, and safe public technical references. https://github.com/ETlvein/AI-Building-PromptStandard 1. 每次 Skill 选择周期都必须进行新的 Online Discovery。 2. Online Discovery 必须与本地 Skill Registry 同时参与选择。 3. 外部 Skill 必须先与本地 Skill 对比。 4. Skill 之间存在任何未解决冲突时禁止共同加载。 5. UNKNOWN compatibility 不等于 COMPATIBLE。 6. Skill 永久保留。 7. 历史版本永久保留。 8. 禁止因为 Skill 相似而自动合并。 9. 禁止用新版覆盖旧版。 10. 每个 Skill 必须保持独立身份与独立目录。 11. Agent 只能使用 AI Control Plane 已批准的 FINAL_SKILL_SET。
README
AI-Building-Skills
Central repository for reusable AI Skills, Skill discovery governance, compatibility control, version retention, and safe public technical references.
Governance
This repository is governed by:
AI-Building-PromptStandard
Locked Prompt Standard reference:
v1.0.0
Repository:
https://github.com/ETlvein/AI-Building-PromptStandard
Core Purpose
本仓库负责保存、发现、审查、版本化和选择可复用 AI Skill。
核心原则:
- 每次 Skill 选择周期都必须进行新的 Online Discovery。
- Online Discovery 必须与本地 Skill Registry 同时参与选择。
- 外部 Skill 必须先与本地 Skill 对比。
- Skill 之间存在任何未解决冲突时禁止共同加载。
- UNKNOWN compatibility 不等于 COMPATIBLE。
- Skill 永久保留。
- 历史版本永久保留。
- 禁止因为 Skill 相似而自动合并。
- 禁止用新版覆盖旧版。
- 每个 Skill 必须保持独立身份与独立目录。
- Agent 只能使用 AI Control Plane 已批准的 FINAL_SKILL_SET。
Public Repository Scope
本公开仓库只允许:
- GLOBAL Skills
- DOMAIN Skills
- Public-safe References
- Skill Registries
- Source Registry
- Compatibility Registry
- Protocols
- Templates
- Schemas
PROJECT Skills 不应默认进入本公开仓库。
项目专属或敏感 Skill 应保存在:
- Project Local Repository
- Private Repository
Skill Discovery Model
每次生成最终 Agent Execution Prompt 前,Skill 选择流程原则上为:
TASK | v ONLINE SKILL DISCOVERY + LOCAL SKILL REGISTRY DISCOVERY | v EXTERNAL / LOCAL COMPARISON | v SOURCE REVIEW | v CANDIDATE SKILL SET | v PAIRWISE COMPATIBILITY CHECK | v SKILL_COMPOSITION_GATE | ±- CONFLICT / UNKNOWN --> BLOCK | v FINAL_SKILL_SET | v AGENT EXECUTION BLOCK
本地已经存在相关 Skill 时,也不能因此跳过新的 Online Discovery。
如果没有适用 Skill:
NO_APPLICABLE_SKILL
是合法结果。
禁止为了“必须使用 Skill”而选择无关 Skill。
Zero-Unresolved-Conflict Rule
多个 Skill 共同加载之前,必须完成兼容性检查。
每一对候选 Skill 至少需要检查:
- Input Contract
- Output Contract
- Tool Requirements
- File Mutation Scope
- Execution Order
- Technology Stack
- Version Requirements
- Permission Requirements
- Security Rules
- Project Governance
- Git Workflow
- Dependency Requirements
只有:
COMPATIBLE
才允许共同加载。
以下结果均禁止共同加载:
- CONFLICT
- UNKNOWN
规则:
NO VERIFIED COMPATIBILITY
NO CO-LOAD
Skill Isolation
每个 Skill 都是独立治理资产。
每个 Skill 必须拥有:
- Independent Skill ID
- Independent Directory
- Independent Manifest
- Independent Source Record
- Independent Version History
- Independent Compatibility Relationships
禁止:
- Skill A 修改 Skill B 的文件
- 因相似而合并 Skill
- 因功能重叠而合并 Skill
- 用新 Skill 覆盖旧 Skill
- 删除不再默认使用的 Skill
Permanent Retention
Skill 生命周期允许:
- DRAFT
- AVAILABLE
- INACTIVE
- QUARANTINED
不使用:
DEPRECATED
因为不再默认选择并不意味着删除或作废。
含义:
DRAFT
尚未完成正式审核。
AVAILABLE
正常允许选择。
INACTIVE
当前默认不选择,但永久保留。
QUARANTINED
因为安全、兼容或治理问题暂时禁止执行,但永久保留。
Version Model
历史版本不可覆盖。
示例:
SKILL_A | |-- v1.0.0 |-- v1.1.0 |-- v2.0.0 | `-- current_version -> v2.0.0
改变 current_version 只改变默认选择版本。
不会删除:
- v1.0.0
- v1.1.0
- 任何其他历史版本
External Skill Discovery
外部发现由:
SKILL_SOURCE_REGISTRY
进行治理。
外部 Skill:
发现不等于批准。
更新不等于覆盖。
相似不等于合并。
新版本必须作为新版本加入。
外部候选在导入前必须进行必要的:
- Source Review
- License Review
- Safety Review
- Secret / Credential Review
- Private Data Review
- Local Comparison
- Compatibility Review
- Project Relevance Review
Registries
SKILL_REGISTRY
负责:
- 本地有哪些 Skill
- Skill Identity
- Skill Version History
- Current Version
- Skill Status
SKILL_SOURCE_REGISTRY
负责:
- Skill 从哪里发现
- External Source
- External Version / Commit
- Source Review
- Update Detection
- Import Decision
- Discovery History
SKILL_COMPATIBILITY_REGISTRY
负责:
- COMPATIBLE
- CONFLICT
- REQUIRES
- ALTERNATIVE
- SIMILAR
- NEWER_THAN
- EXCLUSIVE
以及:
SKILL_COMPOSITION_GATE
REFERENCE_REGISTRY
负责可复用公共技术资料和参考来源。
Selection Audit
每次重要 Skill 选择周期都应保存足够证据,包括:
- Online Search
- Local Registry Search
- External / Local Comparison
- Source Review
- Candidate Set
- Pairwise Compatibility
- Conflict / Unknown Result
- Final Skill Selection
- Rejected Candidates
- Exact Skill Version
- Final Gate Result
模板:
templates/SKILL_SELECTION_AUDIT_TEMPLATE.yaml
Skill Structure
每个正式 Skill 原则上保持独立目录。
Skill 本体与版本化目录结构将在正式 Skill 引入阶段按照永久版本策略建立。
单个 Skill 的核心信息包括:
- SKILL.md
- manifest.yaml
- Version
- Source Identity
- Compatibility Metadata
- Lifecycle Metadata
Repository Structure
AI-Building-Skills
|
|-- CURRENT_SKILLS.yaml
|-- README.md
|-- .gitattributes
|
|-- skills
| |-- global
| -- domain | |-- registries | |-- SKILL_REGISTRY.yaml | |-- SKILL_SOURCE_REGISTRY.yaml | |-- SKILL_COMPATIBILITY_REGISTRY.yaml | – REFERENCE_REGISTRY.yaml
|
|-- protocols
| -- SKILL_DISCOVERY_SELECTION_PROTOCOL.md | |-- references | |-- templates | |-- SKILL_TEMPLATE.md | |-- SKILL_MANIFEST_TEMPLATE.yaml | – SKILL_SELECTION_AUDIT_TEMPLATE.yaml
|
|-- schemas
| -- SKILL_MANIFEST.schema.json | – changelog
`-- CHANGELOG.md
Current Status
Repository Status:
FROZEN
Current public Skills:
0
Current public References:
0
Skill Governance Baseline: V1.0 / FROZEN / OWNER APPROVED
Freeze Date: 2026-09-19
The governance baseline was frozen before the first formal reusable Skill admission cycle.
Publication Model
Local Authoring Source:
D:\AI Building_Skills
Git Published Source:
https://github.com/ETlvein/AI-Building-Skills
本地修改不等于正式发布。
只有经过必要验证并完成:
Git Commit + Git Push + Remote Verification
之后,内容才进入 Published Source。
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add etlvein/ai-building-skills