Skip to content

docs(skill): recommend uv tool install, simplify usage, v0.1.5#257

Merged
manojbajaj95 merged 12 commits into
mainfrom
feature/uv-tool-install-recommendation
May 15, 2026
Merged

docs(skill): recommend uv tool install, simplify usage, v0.1.5#257
manojbajaj95 merged 12 commits into
mainfrom
feature/uv-tool-install-recommendation

Conversation

@manojbajaj95
Copy link
Copy Markdown
Collaborator

Closes #251

Summary

  • Installation: replace alias authsome="uvx authsome@latest" with uv tool install authsome — persistent install means authsome is available directly without reinstalling on every invocation
  • Usage: lead with authsome run -- <command> as the single pattern; add proxy explanation so agents understand why it's required; concrete GitHub and OpenAI examples
  • Structure: usage first, installation and login as reference sections reached only on error — removes the mandatory step-by-step preamble
  • Login: authsome list shown before login so agents discover valid provider names
  • Removed: proxy mode environment check, "Registering a new provider" section, "Advanced features" section
  • Fixed: repo references manojbajaj95agentrhq in issue reporting
  • CRITICAL RULE: moved from description frontmatter to body; rephrased without all-caps
  • Description: sharpened for triggering — names specific providers, fires even when user hasn't mentioned auth
  • Version: 0.1.4 → 0.1.5

Test plan

  • uv tool install authsome in a fresh environment, confirm authsome --version works
  • authsome list, authsome login <provider>, authsome run -- curl https://api.github.com/user all work without alias

🤖 Generated with Claude Code

manojbajaj95 and others added 12 commits May 13, 2026 17:39
Persistent install via `uv tool install authsome` is faster for
repeated agent invocations and reduces hallucinations by letting
agents type `authsome run curl` instead of `uvx authsome@latest run curl`.

Closes #251

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 4a92f2dc3ff1
…ttern

Remove the AUTHSOME_PROXY_MODE branch check — agents should always use
`authsome run -- <command>` without checking environment first. Add
concrete provider examples (GitHub REST, OpenAI, Linear GraphQL) so
agents have copy-paste patterns to follow directly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 81fe81201c45
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 2f061ec5fdb8
Agents now see the authsome run -- pattern immediately. Installation
and login are referenced inline only when needed (command not found /
unauthenticated), removing the mandatory step-by-step preamble.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: befd07322562
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: e9db86c7ba7a
…o body

- Fix gh issue repo: manojbajaj95 → agentrhq (also issues URL)
- Move CRITICAL RULE out of description into skill body
- Description is now focused on triggering: names specific providers,
  fires even when user hasn't mentioned auth
- Login section: add authsome list before login so agents discover
  valid provider names

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: a5a78d400a38
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: a5f1485552cd
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Entire-Checkpoint: e5daa4c86e5a
@manojbajaj95 manojbajaj95 merged commit f264696 into main May 15, 2026
3 checks passed
@manojbajaj95 manojbajaj95 deleted the feature/uv-tool-install-recommendation branch May 15, 2026 13:51
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.

uv tool install should be recommended instead of uvx

2 participants