# Learn

> >

- **Type:** Skill
- **Install:** `agentstack add skill-agentskill-sh-ags-learn`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [agentskill-sh](https://agentstack.voostack.com/s/agentskill-sh)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [agentskill-sh](https://github.com/agentskill-sh)
- **Source:** https://github.com/agentskill-sh/ags/tree/main/skills/learn
- **Website:** https://agentskill.sh

## Install

```sh
agentstack add skill-agentskill-sh-ags-learn
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 ` — 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 "" --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 ""

   | # | Skill | Author | Installs | Security |
   |---|-------|--------|----------|----------|
   | 1 | **** | @ |  | /100 |
   ...

   **Descriptions:**
   1. ****: 
   ...
   ```
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

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

### `/learn @/` — 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 @/ --json`
2. If successful, show the post-install summary (see **Install Flow** step 4)
3. If it fails, say: "Skill @/ not found. Check the name at https://agentskill.sh"

### `/learn skillset:` — 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//install`
3. Parse the JSON response. It returns a `skills` array.
4. Show the skillset preview:
   ```
   ## Skillset: 

   
   **Version:** 
   **Skills included:** 

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

### `/learn ` — 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/`)
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 "" --json --limit 5`
4. Present results with a context header:
   ```
   ## Recommended for Your Project

   Based on your **** 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   [comment]` — Rate a Skill

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli feedback   `
2. Confirm to the user:
   ```
   ## Feedback Submitted

   **Skill:** 
   **Rating:** /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 |
   |-------|--------|-----------|
   | **** | @ |  |
   ...

   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 **** skill(s):
   - 
   - 

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

   All **** installed skills are current.
   ```

### `/learn remove ` — Uninstall a Skill

**Steps:**
1. Run via Bash: `npx @agentskill.sh/cli remove `
2. Confirm: "Removed **** 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: 

   **Score:** /100

   ### Issues Found

   | Severity | Type | Description |
   |----------|------|-------------|
   |  |  |  |
   ...

   ### Recommendation
   
   ```

---

## 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 "" --json --limit 1`
   Or if coming from a search result, use the data already available.
2. Show the skill preview:
   ```
   ## 

   **Author:** @
   **Stats:**  installs
   **Security:** /100

   ---

   
   ```
3. **Confirm installation** (see **Platform Interaction** section):
   - If `AskUserQuestion` is available: header = "Install", question = "Install **** by @?", options = "Yes, install" / "No, cancel"
   - If not available: ask "Install **** 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  --json`
6. Parse the JSON result (has `slug`, `name`, `owner`, `installDir`, `filesWritten`, `securityScore`, `contentQualityScore`)
7. Show post-install summary:
   ```
   ## Installed: 

   **Location:** `/`
   **Files:** 

   ---
   Rate this skill later: `/learn feedback   [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   ""`
3. **Show a brief note** to the user (do not block):
   ```
   ---
   Skill Feedback: Rated **** /5. 
   *Disagree? Run `/learn feedback   [comment]` to override.*
   ```

### User Override

If the user disagrees with your auto-rating, they can override it:
- `/learn feedback   [comment]`
- Or directly: `npx @agentskill.sh/cli feedback   [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   ""`. 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 ''. Try different keywords or browse at https://agentskill.sh" |
| Skill not found (404) | "Skill '' 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. |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [agentskill-sh](https://github.com/agentskill-sh)
- **Source:** [agentskill-sh/ags](https://github.com/agentskill-sh/ags)
- **License:** MIT
- **Homepage:** https://agentskill.sh

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-agentskill-sh-ags-learn
- Seller: https://agentstack.voostack.com/s/agentskill-sh
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.