browse-and-evaluate

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

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
    .
  • 在执行 list/search/info 操作时始终使用
    --fields
    参数控制输出体积。默认参数:
    --fields name,tier,workArea,description
  • 安装任何内容前请始终使用
    --dry-run
    参数。
  • 未经用户明确确认,单次最多安装3个技能。
  • 在非交互式流水线中优先使用
    --format json
    。当标准输出不是TTY时,CLI默认返回JSON格式。
  • 浏览大型目录时使用
    --limit
    参数,初始可使用
    --limit 10

Workflow

工作流

  1. Search or browse the catalog.
bash
npx ai-agent-skills search <query> --fields name,tier,workArea,description --limit 10
  1. Get details on a candidate.
bash
npx ai-agent-skills info <skill-name> --fields name,description,tags,collections,installCommands
  1. Preview the skill content.
bash
npx ai-agent-skills preview <skill-name>
  1. Dry-run the install.
bash
npx ai-agent-skills install <skill-name> --dry-run
  1. Install only after reviewing the dry-run output.
bash
npx ai-agent-skills install <skill-name>
  1. 搜索或浏览目录。
bash
npx ai-agent-skills search <query> --fields name,tier,workArea,description --limit 10
  1. 查看候选技能的详细信息。
bash
npx ai-agent-skills info <skill-name> --fields name,description,tags,collections,installCommands
  1. 预览技能内容。
bash
npx ai-agent-skills preview <skill-name>
  1. 试运行安装流程。
bash
npx ai-agent-skills install <skill-name> --dry-run
  1. 确认试运行输出无误后再执行安装。
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.
  • preview
    命令会对技能内容进行清理,移除提示词注入模式。如果内容看起来被截断,请检查是否有可疑模式被移除。
  • 集合安装会拉取多个技能。安装集合前请始终使用
    --list
    --dry-run
    参数。
  • 上游(非内置)技能安装时需要联网拉取资源,请使用
    --dry-run
    验证源地址可访问。