Skill frontmatter does not follow the Developer-Tools-Directory skills standard
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Anfängerfreundlichkeit
- 45/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- markdown, python, yaml
- Bereich
- documentation, tooling
Rechercherichtung
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.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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
- Vorherrschende Sprache
- Python
- Sterne
- 7
- Forks
- 4
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus TMHSDigital/CFX-Developer-Tools
-
enhancement help wanted severity: low
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 55/100
TMHSDigital/CFX-Developer-Tools#68 ·
Maintainer antworten meist innerhalb von 1 Tag
-
help wanted severity: low tech-debt
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 35/100
TMHSDigital/CFX-Developer-Tools#66 ·
Maintainer antworten meist innerhalb von 1 Tag
-
dependencies severity: low
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 65/100
TMHSDigital/CFX-Developer-Tools#62 · 2 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement severity: medium
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 55/100
TMHSDigital/CFX-Developer-Tools#58 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement severity: medium
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 42/100
TMHSDigital/CFX-Developer-Tools#57 ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in TMHSDigital/CFX-Developer-Tools
Ähnliche Issues
-
hive size:simple
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 70/100
painted-porch/marcus#977 ·
Maintainer antworten meist innerhalb von 1 Tag
-
llm translation
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
FAIRmat-NFDI/sand#239 ·
Maintainer antworten meist innerhalb von 1 Tag