From 18b5428f750fd7ed5519d515410c1e7a8988bee7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=40GTM=EF=BD=9Cyonks=EF=BD=9C=F0=9F=A4=96=F0=9F=8F=9B?= =?UTF-8?q?=EF=B8=8F=F0=9F=AA=99=EF=BD=9CJason=20Younker=20=E2=99=BE?= =?UTF-8?q?=EF=B8=8F?= <3+yonks@noreply.git.weown.tools> Date: Mon, 17 Aug 2026 03:09:21 +0000 Subject: [PATCH] =?UTF-8?q?=E2=99=BE=EF=B8=8F=20WeOwnNet=20=F0=9F=8C=90=20?= =?UTF-8?q?|=20[GUIDE-444.md][=F0=9F=93=8B=20444=20SUITE=20=C2=B7=20Agent?= =?UTF-8?q?=20Skills=20Standard=20SKILL.md=20=C2=B7=20v4.33.7-r2]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit [πŸ†” REF: GTM_2026-W33_7109 | #masterCCC](https://git.weown.tools/WeOwnAI/s004_fedarch/raw/branch/main/_GUIDES_/GUIDE-444.md) ♾️ WeOwnNet 🌐 | [GUIDE-444.md][πŸ“‹ 444 SUITE Β· Agent Skills Standard SKILL.md capability spec Β· v4.33.7-r2] Sun 16 Aug 2026 β€” GUIDE-444 β€” Agent Skills Standard (#ResponsibleAgenticAI + Build the PIPELINE) β€” canonical SKILL.md capability spec closing the 444-SUITE loop (AGENTS.md=who Β· SKILL.md=how Β· MCP=transport) β€” 8/8 MetaCouncil verdict EMBRACE AgentSkills.io (tracker 6076, REF 6135) Β· 10 core SKILL.md practices Β· required frontmatter + folder layout + progressive disclosure + security(P0) Β· DOC: OKF v0.2 (type: Guide) Β· designation LOCKED @GTM fff4908d (tracker 7008) Β· **SOT re-anchored to Gitea ORG WeOwnAI/s004_fedarch/_GUIDES_ (GUIDE-015/415.1 precedent)** Β· BP-075 verifiable footer Β· R-011 ⬜ AWAITING @GTM (#127) Β· APPENDIX TMPL-007 ## @yonks:ADMIN Changes - VERSION: v4.33.7-r2 β€” W33 D7 (Sun 16 Aug 2026) β€” Agent Skills Standard (SKILL.md) β€” r2 = r1 + SOT re-anchor to Gitea ORG WeOwnAI/s004_fedarch/_GUIDES_ (was GH CCCbotNet) per @GTM 22:53:36Z - #masterCCC: GTM_2026-W33_7109 (generation REF; @GTM:ADMIN may re-assign) - FILE: _GUIDES_/GUIDE-444.md - SOT: git.weown.tools/WeOwnAI/s004_fedarch/raw/branch/main/_GUIDES_/GUIDE-444.md - REPO: WeOwnAI 🌐 org / s004_fedarch - FOLDER: _GUIDES_/ - AUTHOR: AI:FedArchBuzz 🐝 (DeepSeek V4 Flash 0731 Β· OKF v0.2 Β· BP-075) β€” #MetaCouncil CANDIDATE - SUBJECT: Agent Skills Standard (SKILL.md capability spec) β€” 444 SUITE β€” #ResponsibleAgenticAI - HASH: 3aa6e25f (Content-SHA256 3aa6e25fbb1cab898619912f35a2b33ab60c1857734b098998cab4c623db6971 Β· 8538 ch Β· 1183 w Β· 167 L Β· bp075_hash.py --verify exit 0) #FlowsBros #FedArch #WeOwnSeason004 #GUIDE444 #AgentSkills #SKILLmd #444Suite #ResponsibleAgenticAI #BuildThePipeline #MetaCouncil #OKFv02 #BP075 #FedArchBuzz #W33 #Milestone ♾️ WeOwnNet 🌐 🏑 Real Estate and 🀝 cooperative ownership for everyone ● An πŸ€— inclusive community, by πŸ‘₯ invitation only. --- _GUIDES_/GUIDE-444.md | 174 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 _GUIDES_/GUIDE-444.md diff --git a/_GUIDES_/GUIDE-444.md b/_GUIDES_/GUIDE-444.md new file mode 100644 index 0000000..96564c8 --- /dev/null +++ b/_GUIDES_/GUIDE-444.md @@ -0,0 +1,174 @@ +--- +type: Guide +title: "GUIDE-444 β€” Agent Skills Standard (SKILL.md): The 444-SUITE Capability Spec {v4.33.7-r2}" +description: "GUIDE-444 = the Agent Skills Standard β€” the canonical SKILL.md capability specification for ♾️ WeOwnNet/WeOwn.Buzz BuzzAgents. Within the 444 SUITE (AGENTS.md = identity Β· SKILL.md = capability Β· MCP = transport), GUIDE-444 defines the SKILL.md payload format adopted ecosystem-wide from the open AgentSkills.io standard (Anthropic-originated, cross-vendor), per the 8/8 MetaCouncil consensus. Authored by FedArchBuzz as deliverable of GTM_2026-W33_7108 track (Gitea push), REF 7109." +tags: [guide-444, 444-suite, agents-md, skill-md, agentskills, skillmd, responsibleagenticai, build-the-pipeline, metacouncil, fedarchbuzz, weownnet, s004, okf, bp-075, w33] +resource: "https://git.weown.tools/WeOwnAI/s004_fedarch/raw/branch/main/_GUIDES_/GUIDE-444.md" +sources: + - id: consensus-8of8 + resource: "mem/agentskills-skillmd-consensus.md (parent REF GTM_2026-W33_6135, tracker 6076)" + author: "πŸ› MetaCouncil (8/8 unanimous)" + last_modified: "2026-08-16" + note: "8/8 NO OBJECTIONS β†’ EMBRACE AgentSkills.io; 10 core SKILL.md practices; avg score 82 (Sage 97 top)." + - id: deepresearch-verdict + resource: "OUTBOX/CONTEXT_BROADCAST_SKILL_STANDARDS_v4.33.6-r1.md (REF 6135, tool-verified 2026-08-15)" + author: "AI:FedArchBuzz 🐝" + last_modified: "2026-08-15" + note: "SKILL.md singular = standard (cross-vendor verified); SKILLS.md plural = legacy aggregate/index only." + - id: prj444-r4 + resource: "https://git.weown.tools/WeOwnNet/s004/raw/branch/main/_PROJECTS_/PRJ-444.md (v4.33.7-r4)" + last_modified: "2026-08-16" + note: "444 SUITE charter; Β§2.5 GUIDE-444 sync (designation LOCKED @GTM fff4908d; tracker 7008)." + - id: agent-skills-io + resource: "https://agentskills.io (HTTP 200, 267,638 B, verified 2026-08-15)" + note: "Open standard; org by Anthropic Oct 2025, open Dec 2025; 37-46+ clients; SKILL.md Required + optional scripts/references/assets." +status: draft +generated: + by: "AI:FedArchBuzz 🐝 (DeepSeek V4 Flash 0731)" + at: "2026-08-16T23:00:00Z" +verified: [] +--- +# πŸ“‹ GUIDE-444 β€” Agent Skills Standard (SKILL.md) + +## πŸ† #GoldStandard β€” v4.33.7-r2 (WeOwnVer) Β· W33 D7 Sun Β· #LLMmodel: DeepSeek V4 Flash 0731 (OpenRouter) + +> **GUIDE-444 is the Agent Skills Standard for ♾️ WeOwnNet 🌐 β€” the canonical SKILL.md capability specification.** It closes the 444-SUITE loop: **AGENTS.md = who you are Β· SKILL.md = what you can DO Β· MCP = how you transport.** Every BuzzAgent ships a conformant `SKILL.md`, and GUIDE-444 is the spec that governs it. + +--- + +## 1 Β· PURPOSE & SCOPE + +| Field | Value | +|:------|:------| +| **Document** | GUIDE-444 | +| **Version** | v4.33.7-r2 βœ… (WeOwnVer) | +| **Folder (SOT)** | `_GUIDES_/` πŸ“‹ β€” **Gitea ORG WeOwnAI/s004_fedarch** (`git.weown.tools/WeOwnAI/s004_fedarch`, GUIDE-015/415.1 precedent) | +| **Suite** | 444 SUITE = AGENTS.md (identity) + **SKILL.md (capability)** + MCP (transport) | +| **Category** | πŸ“‹ GUIDE β€” Agent Skills Standard | +| **Lifecycle** | 🟑 **DRAFT β€” staged for push** (R-011 ⬜ @GTM:ADMIN) | +| **Designation** | LOCKED as **GUIDE-444** per @GTM event `fff4908d` (2026-08-16) Β· tracker `GTM_2026-W33_7008` Β· L-468 GUIDE-4xX (S004 = 4xy) | +| **Author** | AI:FedArchBuzz 🐝 (DeepSeek V4 Flash 0731) | +| **REF** | GTM_2026-W33_7109 (this deliverable) Β· tracker GTM_2026-W33_7108 | +| **Standard** | Google OKF v0.2 (Open Knowledge Format) + BP-075 verifiable footer | + +--- + +## 2 Β· THE ONE-LINE STANDARD + +> **`SKILL.md` (singular, uppercase) inside `skills//` is THE capability payload.** `SKILLS.md` (plural) is allowed ONLY as a root-level index/README β€” never the payload. + +Verified cross-vendor (tool-first 2026-08-15, agentskills.io HTTP 200 Β· Anthropic docs 200 Β· Claude Code docs 94,693 B): this is the open AgentSkills.io standard, originally developed by Anthropic, released open Dec 2025, adopted by 37-46+ clients (Claude Code, Codex/ChatGPT, Copilot, Cursor, Gemini CLI, VS Code). **Our own Buzz harness already conforms** (`.agents/skills/buzz-cli/SKILL.md`, on-disk PoP 11,014 B). + +--- + +## 3 Β· 10 CORE PRACTICES (MetaCouncil 8/8 verdict, deduped) + +| # | Practice | +|:-:|:---------| +| 1 | `SKILL.md` singular = payload Β· `SKILLS.md` plural = root index only | +| 2 | Frontmatter `name` + `description` min; `version` mandatory (WeOwnNet) | +| 3 | Kebab-case folders; **folder name = command** | +| 4 | Self-contained folder + optional `scripts/` `references/` `assets/` | +| 5 | Treat `SKILL.md` as executable code (Aegis P0: review scripts, sandbox, provenance) | +| 6 | Progressive disclosure: Discovery β†’ Activation β†’ Execution | +| 7 | Independent semver per skill; Drift Gate additive-only | +| 8 | Complementary: AGENTS.md=who Β· SKILL.md=how Β· MCP=transport | +| 9 | Portability test on 2+ platforms before MAIT-template lock | +| 10 | EN body; bilingual descriptions + `references/zh/` for F1Visa/APAC (Sage) | + +> **Council scores (1-100):** Sage 97 Β· DRP-P08 96 Β· Aegis 95 Β· DRP-P05 93 Β· DeepPro 73 Β· Sprout 70 Β· MiMo 68 Β· Surge 65 Β· **Avg 82**. Sage = most superior tool-first usage (@GTM observation confirmed). Source: mem/agentskills-skillmd-consensus (parent REF 6135, tracker 6076). + +--- + +## 4 Β· REQUIRED FRONTMATTER (MINIMUM) + +```yaml +--- +name: # folder name = command +description: +version: # mandatory (WeOwnNet) +--- +``` + +Additional recommended (per OKF + suite): `author`, `license`, `dependencies`, `tags`. Unknown keys MUST NOT be rejected (OKF v0.2 Β§4.4). + +--- + +## 5 Β· SKILL FOLDER LAYOUT + +```text +skills// +β”œβ”€β”€ SKILL.md # πŸ”΄ THE payload (Required) +β”œβ”€β”€ scripts/ # optional executable helpers +β”œβ”€β”€ references/ # optional deep docs (/zh/ for bilingual) +└── assets/ # optional static resources +``` + +--- + +## 6 Β· PROGRESSIVE DISCLOSURE (CORE PATTERN) + +1. **Discovery** β€” directory + frontmatter make the skill findable. +2. **Activation** β€” agent reads `SKILL.md` body on invoke (name/description match). +3. **Execution** β€” scripts/references load on demand; body is a pointer, not a dump. + +This keeps context lean and matches BP-404 + our load-on-demand discipline. + +--- + +## 7 Β· SECURITY (Aegis P0 β€” not optional) + +- Treat `SKILL.md` as executable code: **review scripts before use, sandbox execution, verify provenance.** +- Never auto-run unknown skill scripts on a shared/hosted agent surface. +- `scripts/` = reviewed, versioned, signed-in-practice where feasible. + +--- + +## 8 Β· COMPLEMENTARITY WITH THE 444 SUITE + +| Doc | Role | Says | +|:----|:-----|:-----| +| AGENTS.md | Who you are | identity, governance, cage, non-negotiables | +| **SKILL.md** | **What you can DO** | **capability spec ← THIS (GUIDE-444)** | +| MCP | How you transport | tool/skill transport layer | + +--- + +## 9 Β· HOW TO ADOPT (STEPS) + +1. Author each skill as `skills//SKILL.md` with min frontmatter. +2. Keep payload singular `SKILL.md`; use `SKILLS.md` only as root index. +3. Independent semver per skill; Drift Gate additive-only (rN+1 β‰₯ rN). +4. Test portability across 2+ skills-compatible clients before locking into a MAIT template. +5. EN body; add `references/zh/` for bilingual/APAC (Sage). + +--- + +## 10 Β· PROVENANCE & GOVERNANCE + +- **Status:** 🟑 DRAFT β€” staged for push (REF 7109 Β· tracker 7108). R-011 ⬜ NOT assumed (#127). +- **Push** = @GTM:ADMIN / iMAIT (FedArchBuzz stages, never pushes). Target: `_GUIDES_/GUIDE-444.md` on **Gitea ORG WeOwnAI/s004_fedarch** (git.weown.tools, authored @GTM directive 2026-08-16 22:53:36Z; GUIDE-015/415.1 precedent β€” confirmed present). +- **Verify** = live raw-200 + BP-075 `--verify` exit 0 after push. +- **Full context:** PRJ-444 v4.33.7-r4 (charter + Β§2.5 sync) Β· CONTEXT_BROADCAST_SKILL_STANDARDS (verdict) Β· mem/agentskills-skillmd-consensus (verdict). + +--- + +## βœ… REVISION TABLE (rN β†’ rN+1) + +| Version | Change | Drift Gate | +|:--------|:-------|:-----------| +| v4.33.7-r1 | Initial spec authored (this artifact, GH target) | β€” baseline | +| **v4.33.7-r2** | **SOT re-anchored to Gitea ORG WeOwnAI/s004_fedarch/_GUIDES_/** (was GH CCCbotNet; @GTM 22:53:36Z) | βœ… PASS | + +--- + +**REF GTM_2026-W33_7109 Β· NEXT 7110 Β· masterCCC GTM_2026-W32_7029 Β· s004d080 (Sun 16 Aug 2026) Β· #GUIDE444 #AgentSkills #SKILLmd #444Suite #ResponsibleAgenticAI #BuildThePIPELINE #FedArchBuzz #MetaCouncil #OKFv02 #BP075 #FlowsBros** + +♾️ WeOwnNet 🌐 [DUNA] Ecosystem ● 🏑 Real Estate and 🀝 cooperative ownership for everyone ● An πŸ€— inclusive community, *by πŸ‘₯ invitation only*. + +### βœ… BP-075 CANONICAL HASH GENERATED [@GTM:ADMIN generated @ 2026-08-16 16:56 MDT | #HITL by @yonks 21:06 MDT] +Content-SHA256: 3aa6e25fbb1cab898619912f35a2b33ab60c1857734b098998cab4c623db6971 +FEDARCH-CANARY: 3aa6e25f +CHARACTERS: 8538 +WORDS: 1183 +LINES: 167