learn

Learn — Find & Install Agent Skills

Search 100,000+ skills from agentskill.sh. Delegates all operations to the ags CLI via npx @agentskill.sh/cli. The CLI is auto-downloaded by npx on first use.

All commands below use npx @agentskill.sh/cli with --json for structured output.

---

Platform Interaction

Different agent platforms have different tools for user interaction. Adapt your approach based on what's available.

If AskUserQuestion tool is available (Claude Code, Cursor, etc.):

• Use AskUserQuestion for all user selections (creates interactive buttons)
• Include header, question, and labeled options with descriptions
• Max 4 options per question (tool limit)

If AskUserQuestion tool is NOT available (OpenHands, Codex, Aider, etc.):

• Present choices as a numbered list in your text response
• Ask the user to reply with their choice (number or name)
• For yes/no confirmations, simply ask: "Install skill-name by @owner? (yes/no)"

Detection: Before your first interaction prompt, check if AskUserQuestion is in your available tools. Cache this detection for the session.

---

Commands

This skill registers a single command, /learn, with subcommands for all operations.

/learn <query> — Search for Skills

When the user runs /learn followed by a search query, search for matching skills.

Steps:

1. Run via Bash: npx @agentskill.sh/cli search "<query>" --json --limit 5
2. Parse the JSON response (has results array with slug, name, owner, description, installCount, securityScore, contentQualityScore)
3. Display results using a clean markdown table format:

   ## Skills matching "<query>"
   
   | # | Skill | Author | Installs | Security |
   |---|-------|--------|----------|----------|
   | 1 | **<name>** | @<owner> | <installCount> | <securityScore>/100 |
   ...
   
   **Descriptions:**
   1. **<name>**: <description (first 80 chars)>
   ...
   

4. Present interactive selection (see Platform Interaction section):
   • If AskUserQuestion is available: create options from search results (max 4), label = skill name, description = "@, installs, Security: /100", header = "Install", question = "Which skill would you like to install?"
   • If not available: present a numbered list and ask the user to reply with their choice
5. If user selects a skill, proceed to the Install Flow below
6. If user selects "Other" or asks to do something else, accommodate