Skill frontmatter does not follow the Developer-Tools-Directory skills standard
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 45/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- markdown, python, yaml
- Lĩnh vực
- documentation, tooling
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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
- Ngôn ngữ chính
- Python
- Star
- 7
- Fork
- 4
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của TMHSDigital/CFX-Developer-Tools
-
enhancement help wanted severity: low
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
help wanted severity: low tech-debt
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
dependencies severity: low
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement severity: medium
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement severity: medium
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 42/100
TMHSDigital/CFX-Developer-Tools#57 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của TMHSDigital/CFX-Developer-Tools
Issue tương tự
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
-
llm translation
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
FAIRmat-NFDI/sand#239 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug P2
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
coco-research/coco#539 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
dependencies
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
JustBeanie/hass-volcano-hybrid#34 ·
Maintainer thường phản hồi trong vòng 1 ngày