browse-and-evaluate

$npx mdskill add MoizIbnYousaf/Ai-Agent-Skills/browse-and-evaluate

Browse, compare, and evaluate skills before installing them.

  • Helps find the right skill without flooding the context window.
  • Uses the ai-agent-skills CLI with --fields and --dry-run flags.
  • Recommends limiting output with --fields and --limit for large catalogs.
  • Outputs JSON for non-interactive pipelines and requires user confirmation for bulk installs.

SKILL.md

.github/skills/browse-and-evaluateView on GitHub ↗
---
name: browse-and-evaluate
description: Use when exploring the ai-agent-skills catalog to find, compare, and evaluate skills before installing. Always use --fields to limit output size and --dry-run before committing to an install.
category: workflow
version: 4.1.0
---

# Browse And Evaluate

## Goal

Find the right skill for a task without flooding the context window or installing blindly.

## Guardrails

- Always use `--fields` on list/search/info to keep output small. Default: `--fields name,tier,workArea,description`.
- Always use `--dry-run` before installing anything.
- Never install more than 3 skills at once without explicit user confirmation.
- Prefer `--format json` in non-interactive pipelines. The CLI defaults to JSON when stdout is not a TTY.
- Use `--limit` when browsing large catalogs. Start with `--limit 10`.

## Workflow

1. Search or browse the catalog.

```bash
npx ai-agent-skills search <query> --fields name,tier,workArea,description --limit 10
```

2. Get details on a candidate.

```bash
npx ai-agent-skills info <skill-name> --fields name,description,tags,collections,installCommands
```

3. Preview the skill content.

```bash
npx ai-agent-skills preview <skill-name>
```

4. Dry-run the install.

```bash
npx ai-agent-skills install <skill-name> --dry-run
```

5. Install only after reviewing the dry-run output.

```bash
npx ai-agent-skills install <skill-name>
```

## Gotchas

- The `preview` command sanitizes skill content to strip prompt injection patterns. If content looks truncated, check if suspicious patterns were removed.
- Collection installs pull multiple skills. Always `--list` or `--dry-run` a collection before installing.
- Upstream (non-vendored) skills require a network fetch at install time. Use `--dry-run` to verify the source is reachable.

More from MoizIbnYousaf/Ai-Agent-Skills

SkillDescription
ask-questions-if-underspecifiedClarify requirements before implementing. Do not use automatically, only when invoked explicitly.
audit-library-healthUse when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.
backend-developmentBackend API design, database architecture, microservices patterns, and test-driven development. Use for designing APIs, database schemas, or backend system architecture.
build-workspace-docsUse when regenerating README.md and WORK_AREAS.md in a managed library workspace. Always dry-run first to preview changes.
code-documentationWriting effective code documentation - API docs, README files, inline comments, and technical guides. Use for documenting codebases, APIs, or writing developer guides.
curate-a-team-libraryUse when building a managed team skills library for a real stack. Map work to shelves, browse before curating, write meaningful `whyHere` notes, and create a starter pack once the first pass is solid.
install-from-remote-libraryUse when installing skills from a shared ai-agent-skills library repo. Inspect with `--list` first, prefer `--collection`, and preview with `--dry-run` before installing.
llm-application-devBuilding applications with Large Language Models - prompt engineering, RAG patterns, and LLM integration. Use for AI-powered features, chatbots, or LLM-based automation.
migrate-skills-between-librariesUse when moving skills between library workspaces or upgrading from a personal library to a team library. Export from one workspace, import into another.
review-a-skillUse when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.