Skip to content

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

Merged
schpet merged 4 commits intoschpet:mainfrom
c-99-e:improve-skill-docs
Mar 25, 2026
Merged

skill: improve SKILL.md with bunx fallback, required flags, and --no-pager caveat#182
schpet merged 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
@schpet schpet merged commit cb749d3 into schpet:main Mar 25, 2026
11 checks passed
@schpet
Copy link
Owner

schpet commented Mar 25, 2026

@c-99-e thank you!

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