Skill frontmatter does not follow the Developer-Tools-Directory skills standard
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 3/5
- 預估耗時
- 1-2 天
- 新手友好度
- 45/100
- Issue 類型
- 文件
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- markdown, python, yaml
- 領域
- documentation, tooling
研究方向
Open skills/state-bags/SKILL.md first to see the current title/description/globs/standards-version frontmatter, then read the Developer-Tools-Directory standards/skills.md it cites. The change spans all ten skills/*/SKILL.md files plus CLAUDE.md, AGENTS.md, .cursorrules and CONTRIBUTING.md, and the acceptance criteria add a frontmatter check to the MCP suite run with cd mcp-server && python -m pytest. Done means every skill carries the agreed fields and CI fails when one is missing.
由索引模型根據 Issue 內容生成。
描述
Summary
All 10 skills use frontmatter title, description, standards-version (and globs), but the Developer-Tools-Directory skills standard (standards/skills.md) requires name (kebab-case, matching the folder), description (under 200 characters, starting with a verb) and triggers (3-8 natural-language phrases), plus a body with "When to use" / "When NOT to use" sections.
Where
skills/*/SKILL.md(frontmatter of all 10 skills, for exampleskills/state-bags/SKILL.md:1-6)CLAUDE.mdandCONTRIBUTING.md(now say to match the existing files until the skills are migrated)
Details
---
title: State Bags
description: Modern data synchronization using State Bags instead of TriggerClientEvent patterns
globs: ["**/*.lua", "**/*.js", "**/*.cs"]
standards-version: 1.10.0
---
The standard's required shape is:
---
name: state-bags
description: Sync entity and player data with State Bags instead of TriggerClientEvent.
triggers:
- "sync data to clients"
- "state bag"
- "replicate entity state"
---
No skill has name or triggers. The docs were corrected to describe the current files (see #48), which leaves the repo knowingly out of step with the standard.
Impact
Agents and tooling that route skills by name/triggers (as the standard intends) get nothing from these skills, and contributors see two conflicting conventions. A future standards check over skills would fail every file.
Suggested fix
- Decide whether this repo adopts the standard (recommended, since sibling repos are expected to) or the standard documents the
title/standards-versionshape. - If adopting: add
nameandtriggersto each skill, trimdescriptionto the standard's form, keep or dropglobsas the standard's optionalscope, and add the "When to use" / "When NOT to use" sections. - Then update CLAUDE.md, AGENTS.md, .cursorrules and CONTRIBUTING.md to state a single convention, and add a frontmatter check (parse YAML, required fields present) to the MCP server test suite or validate.yml.
Acceptance criteria
- Every
skills/*/SKILL.mdfollows one documented frontmatter convention. - CLAUDE.md, AGENTS.md, .cursorrules and CONTRIBUTING.md describe that same convention.
- CI fails when a skill is missing a required frontmatter field.
Getting started
- Relevant files:
skills/*/SKILL.md,CLAUDE.md,CONTRIBUTING.md - How to run tests:
cd mcp-server && pip install -r requirements-dev.txt && python -m pytest - Related docs: Developer-Tools-Directory
standards/skills.md
Related: #48, #61
Filed by repo-audit/fix-issues at e061709. Severity: low. Effort: M. audit-key: tech-debt|skills/state-bags/SKILL.md|frontmatter-standard
- 主要語言
- Python
- 星號
- 7
- 分支
- 4
- PR 合併指標
- 30 天內沒有已合併 PR
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
TMHSDigital/CFX-Developer-Tools 的其他 Issue
-
enhancement help wanted severity: low
難度 3/5 1-2 天 新手友好度 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
維護者通常 1 天內回覆
-
help wanted severity: low tech-debt
難度 4/5 3-5 天 新手友好度 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
維護者通常 1 天內回覆
-
dependencies severity: low
難度 3/5 1-2 天 新手友好度 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 則留言 ·
維護者通常 1 天內回覆
-
enhancement severity: medium
難度 3/5 1-2 天 新手友好度 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 則留言 ·
維護者通常 1 天內回覆
-
enhancement severity: medium
難度 4/5 3-5 天 新手友好度 42/100
TMHSDigital/CFX-Developer-Tools#57 ·
維護者通常 1 天內回覆
查看 TMHSDigital/CFX-Developer-Tools 的全部 Issue
相似的 Issue
-
hive size:simple
難度 2/5 1-3 小時 新手友好度 78/100
維護者通常 1 天內回覆
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)未關閉
難度 2/5 1-3 小時 新手友好度 68/100
-
難度 2/5 1-3 小時 新手友好度 70/100
painted-porch/marcus#977 ·
維護者通常 1 天內回覆
-
llm translation
難度 2/5 1-3 小時 新手友好度 82/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 78/100
FAIRmat-NFDI/sand#239 ·
維護者通常 1 天內回覆