Skip to content

README/CHANGELOG link /debug skill to ./skills/debug/SKILL.md, a path that doesn't exist (actual source: docs/agent-resources/) #91

@burrows99

Description

@burrows99

Summary

The README and CHANGELOG present the /debug Agent Skill as living at skills/debug/ and link to ./skills/debug/SKILL.md, but that path has never existed in the repo — both links 404. The actual skill source is committed at docs/agent-resources/debug_instructions.md (+ docs/agent-resources/troubleshooting/*.md, per AGENTS.md).

Details

  • README.md (lines ~22 and ~70) link to ./skills/debug/SKILL.md → 404. No skills/ directory exists on main or anywhere in history.
  • CHANGELOG.md describes a "bundled companion skill at skills/debug/".
  • src/utils/agentConfigurationManager.ts:206 copies the skill from <extensionPath>/skills/debug; if absent it logs Bundled debugmcp skill not found … skipping skill registration (line 218) and silently skips. The build (vscode:prepublishtsc only) has no step that assembles skills/debug/ from docs/agent-resources/, so the packaged path isn't reproducible from source.

Suggested fix

Either (a) point the README/CHANGELOG links at the real source (docs/agent-resources/debug_instructions.md), or (b) commit skills/debug/SKILL.md / add a build step that generates it from docs/agent-resources/, so the documented path and the runtime copy source actually exist.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions