Skip to content

Confusing docs around tools specification for .prompt.md files (custom commands) #9119

Open
Open
Confusing docs around tools specification for .prompt.md files (custom commands)#9119
Assignees
ntrogh
Labels
doc-bugout of date, inaccurate, confusing content

Description

@lirantal
Liran Tal (lirantal)
opened on Nov 30, 2025

The VS Code docs I found refer to tool sets, and to tools and different sort of notation for it like #edit vs edit/edit_file or similar which is oddly confusing.

This is how I ended up configuring the custom command:

Image

Activity

  1. Nick Trogh (ntrogh)
    self-assigned this
    on Dec 2, 2025
  2. Nick Trogh (ntrogh)
    added
    doc-bugout of date, inaccurate, confusing content
    on Dec 2, 2025
  3. Nick Trogh (ntrogh)
    added this to the milestone on Dec 2, 2025

  4. DakotaB75 commented on Dec 19, 2025

    @DakotaB75
    Dakota Bazan (DakotaB75)
    on Dec 19, 2025
    Contributor

    I can help clarify the documentation by explicitly explaining the differences between tool set notation and individual tool identifiers (for example #edit vs edit/edit_file), and by adding a concrete example of a .prompt.md custom command configuration.

    If that approach sounds good, I’m happy to open a PR.

  5. ntrogh commented on Dec 19, 2025

    @ntrogh
    Nick Trogh (ntrogh)
    on Dec 19, 2025
    Collaborator

    Liran Tal (@lirantal) This issue is already assigned and is part of this milestone. Appreciate the offer.

  6. João Moreno (joaomorenoalt)
    removed this from the milestone on Jan 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

doc-bugout of date, inaccurate, confusing content

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions