Skip to content

skill: improve SKILL.md with bunx fallback, required flags, and --no-pager caveat#182

Open
c-99-e wants to merge 4 commits intoschpet:mainfrom
c-99-e:improve-skill-docs
Open

skill: improve SKILL.md with bunx fallback, required flags, and --no-pager caveat#182
c-99-e wants to merge 4 commits intoschpet:mainfrom
c-99-e:improve-skill-docs

Conversation

@c-99-e
Copy link

@c-99-e c-99-e commented Mar 18, 2026

A few practical improvements based on real usage friction:

  • Prerequisites: Added bunx linear as a zero-install fallback for when linear isn't on PATH
  • Discovering Options: Added a note about commands with non-obvious required flags — specifically that issue list requires --sort (valid values: manual, priority) and --team, and that --no-pager is only supported on issue list

@c-99-e c-99-e marked this pull request as ready for review March 18, 2026 17:02
Copy link
Owner

@schpet schpet left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks! this skill is pretty weak so appreciate refinements based on real usage

@c-99-e
Copy link
Author

c-99-e commented Mar 18, 2026

Thanks for the catch! The bunx linear example was actually working for me because @schpet/linear-cli was already installed locally in my project; bunx just picked up the local binary. Fixed it to use npx @schpet/linear-cli with the correct package name throughout.

@c-99-e c-99-e requested a review from schpet March 19, 2026 07:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants