Skip to content
Skills Library
AI & agents · Tool integration

learn

/learn

Search, install, update, and rate AI agent skills from agentskill.sh (100,000+ skills). Use when the user asks to find skills, install extensions or plugins, discover new capabilities, check what skills are available, or says "how do I do X" when a skill might help. Also handles listing installed skills, checking for updates, rating skills, removing skills, and scanning skills for security issues. Triggers on: /learn, find skill, install skill, search skills, what skills, add capability, get plugin, check skill safety.

Repository
ags ↗
Licence
MIT
Last repository change
11.05.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
10
Deprecation

No signals detected. Repository changed on 11.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Search, install, update, and rate AI agent skills from agentskill.sh (100,000+ skills). Use when the user asks to find skills, install extensions or plugins, discover new capabilities, check what skills are available, or says "how do I do X" when a skill might help. Also handles listing installed skills, checking for updates, rating skills, removing skills, and scanning skills for security issues. Triggers on: /learn, find skill, install skill, search skills, what skills, add capability, get plugin, check skill safety.

Triggers from the description

how do I do X
Original author description

Search, install, update, and rate AI agent skills from agentskill.sh (100,000+ skills). Use when the user asks to find skills, install extensions or plugins, discover new capabilities, check what skills are available, or says "how do I do X" when a skill might help. Also handles listing installed skills, checking for updates, rating skills, removing skills, and scanning skills for security issues. Triggers on: /learn, find skill, install skill, search skills, what skills, add capability, get plugin, check skill safety.

How it works

  1. Platform Interaction
  2. Commands
  3. Install Flow
  4. Self-Update
  5. Automatic Skill Rating (Agent Self-Rating)
  6. Session Skill Tracking
  7. Error Handling
Original SKILL.md headings · 331 lines, 1,780 words
SKILL.md preview
---
name: learn
description: >
  Search, install, update, and rate AI agent skills from agentskill.sh
  (100,000+ skills). Use when the user asks to find skills, install
  extensions or plugins, discover new capabilities, check what skills
  are available, or says "how do I do X" when a skill might help.
  Also handles listing installed skills, checking for updates, rating
  skills, removing skills, and scanning skills for security issues.
  Triggers on: /learn, find skill, install skill, search skills,
  what skills, add capability, get plugin, check skill safety.
metadata:
  author: agentskill-sh
  version: "3.1"
compatibility: Requires Node.js 18+ (for npx)
includes:
  - references/**
---

# Learn — Find & Install Agent Skills

Search 100,000+ skills from [agentskill.sh](https://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 = "@<owner>, <installCount> installs, Security: <securityScore>/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

If no results are found, say: "No skills found for '<query>'. Try different keywords or browse at https://agentskill.sh"

### `/learn @<owner>/<slug>` — Install Exact Skill

When the argument starts with `@`, treat it as a direct install request.

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli install @<owner>/<slug> --json`
2. If successful, show the post-install summary (see **Install Flow** step 4)
3. If it fails, say: "Skill @<owner>/<slug> not found. Check the name at https://agentskill.sh"

### `/learn skillset:<slug>` — Install a Skillset (Bundle of Skills)

When the argument starts with `skillset:`, treat it as a skillset install request.

**Steps:**
1. Parse the skillset slug from the argument (strip the `skillset:` prefix)
2. Use WebFetch to call: `https://agentskill.sh/api/agent/skillsets/<slug>/install`
3. Parse the JSON response. It returns a `skills` array.
4. Show the skillset preview:
   ```
   ## Skillset: <name>

   <description>
   **Version:** <version>
   **Skills included:** <skillCount>

   | # | Skill | Author | Security |
   |---|-------|--------|----------|
   | 1 | **<name>** | @<owner> | <securityScore>/100 |
   ...
   ```
5. **Confirm installation** (see **Platform Interaction**)
6. If confirmed, install each skill: `npx @agentskill.sh/cli install <slug> --json` for each
7. Show post-install summary

### `/learn <url>` — Install from URL

When the argument starts with `http`, treat it as a URL install.

**Steps:**
1. Parse the slug from the URL path (last segment of `https://agentskill.sh/<slug>`)
2. Proceed to **Install Flow** with that slug

### `/learn` (no arguments) — Context-Aware Recommendations

When `/learn` is run with no arguments, analyze the current project and recommend skills.

**Steps:**
1. Detect the current project context:
   - Read `package.json` if it exists (extract key dependencies)
   - Check for language indicators: `.py` files, `.rs`, `.go`, `.rb`, etc.
   - Check for config files: `tailwind.config`, `docker-compose.yml`, `prisma/schema.prisma`
   - Read the current git branch name via Bash: `git branch --show-current`
2. Build a search query from detected context (e.g., "nextjs prisma", "stripe payments")
3. Run: `npx @agentskill.sh/cli search "<constructed query>" --json --limit 5`
4. Present results with a context header:
   ```
   ## Recommended for Your Project

   Based on your **<detected stack>** project:
   ```
5. Display results using the same table format and interactive selection flow

### `/learn trending` — Show Trending Skills

**Steps:**
1. Use WebFetch to call: `https://agentskill.sh/api/agent/search?section=trending&limit=5`
2. Display trending skills using the same table format and interactive selection flow
3. Use header "Trending" and question "Which trending skill would you like to install?"

### `/learn feedback <slug> <score> [comment]` — Rate a Skill

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli feedback <slug> <score> <comment if provided>`
2. Confirm to the user:
   ```
   ## Feedback Submitted

   **Skill:** <slug>
   **Rating:** <score>/5

   Thank you. This helps other agents find the best skills.
   ```

### `/learn list` — Show Installed Skills

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli list --json`
2. Parse the JSON response (has `skills` array with `slug`, `owner`, `contentSha`, `installed`, `dir`)
3. Display using a **clean table format**:
   ```
   ## Installed Skills

   | Skill | Author | Installed |
   |-------|--------|-----------|
   | **<slug>** | @<owner> | <relative date> |
   ...

   Run `/learn update` to check for updates.
   ```

### `/learn update` — Check for Updates

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli update --json`
2. Parse the JSON response (`updated` array and `upToDate` count)
3. If updates were applied:
   ```
   ## Updates Applied

   Updated **<count>** skill(s):
   - <slug-1>
   - <slug-2>

   <upToDate> skill(s) were already current.
   ```
4. If all up to date:
   ```
   ## All Up to Date

   All **<count>** installed skills are current.
   ```

### `/learn remove <slug>` — Uninstall a Skill

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli remove <slug>`
2. Confirm: "Removed **<slug>** from installed skills."

### `/learn scan [path]` — Security Scan a Skill

When the user asks to check a skill's safety, audit a SKILL.md, or scan for security issues.

**Steps:**
1. Read the SKILL.md at the given path (default: current directory)
2. Read [references/SECURITY.md](references/SECURITY.md) for the full scanning rubric
3. Check the skill content against critical, high, and medium-risk patterns from the rubric
4. Output a scan report:
   ```
   ## Security Scan: <RATING>

   **Score:** <score>/100

   ### Issues Found

   | Severity | Type | Description |
   |----------|------|-------------|
   | <severity> | <category> | <what was found> |
   ...

   ### Recommendation
   <ALLOW / REVIEW / BLOCK>
   ```

---

## Install Flow

This is the shared installation procedure used by search, direct install, and URL install.

**Steps:**
1. First, get skill info to show preview. Run via Bash: `npx @agentskill.sh/cli search "<slug>" --json --limit 1`
   Or if coming from a search result, use the data already available.
2. Show the skill preview:
   ```
   ## <name>

   **Author:** @<owner>
   **Stats:** <installCount> installs
   **Security:** <securityScore>/100

   ---

   <description>
   ```
3. **Confirm installation** (see **Platform Interaction** section):
   - If `AskUserQuestion` is available: header = "Install", question = "Install **<name>** by @<owner>?", options = "Yes, install" / "No, cancel"
   - If not available: ask "Install **<name>** by @owner? (yes/no)"
4. **Security check:** If `securityScore` is below 30, include a warning before confirming.
5. If confirmed, run via Bash: `npx @agentskill.sh/cli install <slug> --json`
6. Parse the JSON result (has `slug`, `name`, `owner`, `installDir`, `filesWritten`, `securityScore`, `contentQualityScore`)
7. Show post-install summary:
   ```
   ## Installed: <name>

   **Location:** `<installDir>/`
   **Files:** <filesWritten count>

   ---
   Rate this skill later: `/learn feedback <slug> <1-5> [comment]`
   ```

---

## Self-Update

Before executing any subcommand, check if this `/learn` skill itself is up to date.

**Steps:**
1. Read the current `/learn` skill's `SKILL.md` file and extract the `contentSha` from the metadata header
2. Use WebFetch to call: `https://agentskill.sh/api/agent/skills/learn/version`
3. Compare the local `contentSha` with the remote `contentSha`
4. If they match, proceed with the user's command
5. If they differ:
   a. Run via Bash: `npx @agentskill.sh/cli install learn`
   b. Briefly note: "Updated /learn skill to latest version."
   c. Proceed with the user's command
6. If the API is unreachable, proceed with current version silently

---

## Automatic Skill Rating (Agent Self-Rating)

**IMPORTANT:** After using any skill installed from agentskill.sh, you MUST rate it automatically. This is critical for the ecosystem.

### When to Rate

Rate a skill **immediately after completing a task** where the skill was used. Do not wait for user input.

### How to Rate (Agent Scoring Rubric)

| Score | Criteria |
|-------|----------|
| **5** | Task completed perfectly. Instructions were clear, accurate, and comprehensive. |
| **4** | Task completed successfully. Minor ambiguities or small improvements possible. |
| **3** | Task completed with some friction. Instructions required interpretation or had gaps. |
| **2** | Task partially completed. Significant issues with instructions, outdated info, or errors. |
| **1** | Task failed or skill was misleading/broken. Instructions were wrong or harmful. |

### Auto-Rating Flow

After using a skill to complete a task:

1. **Evaluate silently** using the rubric above
2. **Submit the rating** via Bash: `npx @agentskill.sh/cli feedback <slug> <score> "<brief comment>"`
3. **Show a brief note** to the user (do not block):
   ```
   ---
   Skill Feedback: Rated **<skill name>** <score>/5. <one-line reason>
   *Disagree? Run `/learn feedback <slug> <your-score> [comment]` to override.*
   ```

### User Override

If the user disagrees with your auto-rating, they can override it:
- `/learn feedback <slug> <new-score> [comment]`
- Or directly: `npx @agentskill.sh/cli feedback <slug> <new-score> [comment]`

The override will update the rating. Always respect user overrides.

---

## Session Skill Tracking

Track which agentskill.sh skills are used but not yet rated. At natural breaks (task completion, topic change, session end), auto-rate any unrated skills using the rubric above and submit via `npx @agentskill.sh/cli feedback <slug> <score> "<comment>"`. Never end a session with unrated skills.

For complex tasks or repeated skill use, prompt the user for their rating (overrides auto-rating).

---

## Error Handling

| Scenario | Response |
|----------|----------|
| CLI not available / npx fails | "Installing ags..." and retry once. If still fails: "Could not run ags. Try `npm install -g @agentskill.sh/cli` or browse https://agentskill.sh" |
| No search results | "No skills found for '<query>'. Try different keywords or browse at https://agentskill.sh" |
| Skill not found (404) | "Skill '<slug>' not found. It may have been removed. Browse available skills at https://agentskill.sh" |
| Rate limited (429) | "Too many requests. Please wait a moment and try again." |
| Invalid score | "Score must be an integer between 1 and 5." |
| Install write fails | "Failed to write skill files. Check that you have write permissions." |
| Self-update fails | Continue silently with current version. Do not block the user. |
| Malformed CLI output | Re-run with stderr redirected (`npx @agentskill.sh/cli search "q" --json 2>/dev/null`). If still malformed, parse what you can or fall back to non-JSON mode. |
Files in this package (2)
  • SKILL.md 13 KB
  • references/SECURITY.md 18 KB

Versions

RepositoryScoreLicence
This page · agentskill-sh/ags100MIT
lucamartins/ouroboros100MIT
boykush/scraps100MIT
nicsuzor/academicops100MIT
cookys/autopilot100MIT
joelhooks/PAROL6100MIT
tw93/Waza100MIT
fainir/agent-harness100MIT
amit429/understanding-map100MIT

Database snapshot: 13.11.2026 · package version d77567256cda (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100install-skill
    Search and install skills from skills.sh and GitHub repos. Use when users ask to find skills, install skills, download skills, add skills from GitHub, search for skills, browse skills, get a skill, or want new capabilities. Trigger phrases include "install skill", "find skill",…
  • 100find-skills
    List installed skills, search the skill registry, install new skills, and manage workspace extensions. Use when the user asks to find, install, list, or configure skills, or mentions skill registry, extensions, or workspace capabilities.
  • 100find-skills
    Search, install, update, and remove third-party Agent Skills from skills.sh or any GitHub/GitLab repo via the `npx skills` CLI. Use when the user wants to "find a skill", "install a skill from github", "search skills.sh", or add third-party capabilities to Claude…
  • 100manage-skills
    Use when the user wants to find, install, or manage agent skills from skills.sh. Triggers on requests like "find a skill for", "install a skill", "browse skills", "what skills are available", or any mention of skills.sh.
  • 100manage-skills
    Install, remove, and inspect skills from a clone of the kapo-skills repo. Use when someone asks to install or add a skill, see which skills they have, remove or uninstall a skill, update their shared skills, or when a skill that should be available isn't showing up.
  • 100sc-skill
    SI-Coder skill discovery and installation workflow. Search installed Agent Skills by keyword, inspect matching slash skills, create a new managed skill, or install a complete skill bundle with scripts/references/assets using sc-skill. Use when the user asks to find a skill for…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.