Skip to content

wayfinder: SKILL.md never says what argument it takes, so users pass PR links #1217

Description

@nnegi88

What happened

Across one evening I invoked /wayfinder nine times. Three of those passed a GitHub PR URL (and once a PR comment URL) instead of a map or a loose idea. Each time the agent fetched the PR, found it green and mergeable with nothing to decide, and had to ask what the loose idea actually was. The user never saw, in the skill's own words, what the argument should be.

The intro describes the shape (map or loose idea) only implicitly, via the two invocation modes near the bottom of a long document. There is no front-loaded line stating what ARGUMENTS may be.

Suggestion

One sentence at the top of SKILL.md, before the prose, e.g.:

Takes either a map (issue URL/number or map file path) to work through, or a loose idea in words to chart. A PR, commit or finished issue is neither; report its status and ask for the idea.

Optionally, a short "Neither mode fits" exit in the Invocation section so the agent's behaviour on a PR link is specified rather than improvised.

Plugin version 1.2.3 and 1.3.1, Claude Code, local-markdown tracker.

Activity

  1. mattpocock commented on Oct 8, 2026

    @mattpocock
    Owner

    This was generated by AI during triage.

    Thanks for the write-up. The Invocation section already states the two modes (a loose idea to chart, or a map to work through), and when given a PR link the agent did the right thing: it found nothing to decide and asked for the idea. Nothing went wrong in the skill, so I'm not adding an arguments preamble. Closing.

    See: https://github.com/mattpocock/skills/blob/main/SCOPE.md#the-bar

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-triageMaintainer needs to evaluate

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions