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

Maintainers usually reply within 1 day

Assessment

This issue has not been assessed yet.

Description

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:

Getting set up

First steps

1. Read the whole issue, then the project's contributing guide.
2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
3. Fork the repository and make your change on a branch.
4. Open a pull request that references the issue number.

More from microsoft/vscode-docs

• Clarify EU data residency and DPA scope for Claude harness with Copilot authentication

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  triage-needed

  Difficulty 2/5 1-3 hours Newbie friendliness 70/100

  microsoft/vscode-docs#10626 · Opened Nov 10, 2026

  Maintainers usually reply within 1 day

• Agent plugin migration: gaps in package conversion, canvas discovery, and hook stdout guidance

  Possibly taken @jebakishore509-sys claimed this 12 days ago. Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 54/100

  microsoft/vscode-docs#10551 · Opened Oct 27, 2026

  Maintainers usually reply within 1 day

• Temporary workaround: publish VS Code extensions with an organization-scoped PAT

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  doc-enhancement

  Difficulty 1/5 Under an hour Newbie friendliness 45/100

  microsoft/vscode-docs#10526 · 1 reaction · Opened Oct 21, 2026

  Maintainers usually reply within 1 day

• Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds (span:nth-child(6)):A11y_code.visualstudio.com_AI4W

  May be free again @ntrogh claimed this 38 days ago, and no pull request is open. Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  microsoft/vscode-docs#10424 · 1 comment · 1 assignee · Opened Oct 5, 2026

  Maintainers usually reply within 1 day

• How VS Code team uses AI

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  idea

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  microsoft/vscode-docs#10216 · 1 comment · Opened Sep 1, 2026

  Maintainers usually reply within 1 day

All issues in microsoft/vscode-docs