Skill frontmatter does not follow the Developer-Tools-Directory skills standard
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 3/5
- Tempo stimato
- 1-2 giorni
- Idoneità per principianti
- 45/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- markdown, python, yaml
- Ambito
- documentation, tooling
Direzione di ricerca
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.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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
- Lingua principale
- Python
- Stelle
- 7
- Fork
- 4
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di TMHSDigital/CFX-Developer-Tools
-
enhancement help wanted severity: low
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
I maintainer di solito rispondono entro 1 giorno
-
help wanted severity: low tech-debt
Difficoltà 4/5 3-5 giorni Idoneità per principianti 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
I maintainer di solito rispondono entro 1 giorno
-
dependencies severity: low
Difficoltà 3/5 1-2 giorni Idoneità per principianti 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
enhancement severity: medium
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
enhancement severity: medium
Difficoltà 4/5 3-5 giorni Idoneità per principianti 42/100
TMHSDigital/CFX-Developer-Tools#57 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di TMHSDigital/CFX-Developer-Tools
Issue simili
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
llm translation
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
FAIRmat-NFDI/sand#239 ·
I maintainer di solito rispondono entro 1 giorno
-
bug P2
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
coco-research/coco#539 ·
I maintainer di solito rispondono entro 1 giorno
-
dependencies
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
JustBeanie/hass-volcano-hybrid#34 ·
I maintainer di solito rispondono entro 1 giorno