Token导航 LogoToken导航

Agent Skill · 研究检索

agent-instruction(Agent 指令)

用于辅助提示词、系统指令、Agent 行为约束和工作流模板的整理。它适合让 Agent 规范任务边界、统一输出格式、拆分操作步骤或优化提示词可复用性。使用时需要保留真实业务约束,不要把示例当硬规则;涉及自动执行、外部工具或高风险操作时,应在提示词中明确确认步骤、权限边界和失败处理方式。

agent-instruction 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 71,596。

总安装 194周安装 8GitHub Stars 公开资料未说明下载 63核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:agent-instruction(Agent 指令)
来源仓库:https://github.com/validkeys/agent-instruction
仓库路径:skills/agent-instruction
安装命令:
npx skills add https://github.com/validkeys/agent-instruction --skill agent-instruction
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/validkeys/agent-instruction --skill agent-instruction

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

Agent 指令技能用于在 monorepo 中管理 AI 指令文件,帮助开发会话中的最佳实践发现。适用于添加规则、构建指令文件和优化提示词可复用性的场景。通过 GitHub 安装并使用 npx skills add 命令加载,需结合原始 README 核验具体用法。

安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。注意该技能依赖 agent-instruction CLI 工具,需确保已安装并在 PATH 中。

来源仓库内路径:skills/agent-instruction

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/validkeys/agent-instruction --skill agent-inst…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

agent-instruction 怎么安装?

在终端执行 npx skills add https://github.com/validkeys/agent-instruction --skill agent-instruction。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

agent-instruction 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

agent-instruction 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

agent-instruction 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

agent-instruction 用的人多吗?

公开数据是累计安装 194 次,近一周安装 8 次,下载 63 次。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

agent-instruction 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
agent-instruction

Agent 指令 · 本页

194—只读未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

agent-instruction

Manage AI instruction files in monorepos during development sessions. This skill bridges the gap between discovering best practices during development and codifying them as durable instructions.

Use the agent-instruction CLI to add rules, build instruction files, and list existing rules.

Requires: agent-instruction CLI installed and in PATH (go install github.com/validkeys/agent-instruction@latest)

Commands

add_rule

Add a new instruction rule to a rule file.

agent-instruction add "[rule content]" --title "[title]" --rule="[rule-file]"
  • content (required): The instruction rule text
  • --title (optional): Heading for the rule section
  • --rule (optional): Target rule file name (prompts interactively if omitted)

Examples:

agent-instruction add "Always use table-driven tests in Go" --title="Testing Standards" --rule="testing"
agent-instruction add "Never use global variables" --title="Code Standards"
agent-instruction add "Validate all user input before database queries" --rule="security"

build

Generate or update instruction files (CLAUDE.md, AGENTS.md) from all rule configurations.

agent-instruction build

list

Display all available rule files and their contents.

agent-instruction list [--verbose]
  • --verbose (optional): Show full rule content with formatting

Best Practices

  • Check before adding: Run agent-instruction list --verbose before adding a rule to avoid duplicates.
  • Build after changes: After adding multiple rules, run agent-instruction build to propagate changes to CLAUDE.md and AGENTS.md.
  • Use descriptive titles: Clear, specific titles make rules easy to find later.
  • Group related rules: Use category-named rule files — e.g., testing.json, security.json, golang.json, global.json.
  • When to add rules: When the user says "remember this for next time", when a recurring mistake is found, or when a new standard is established.

Notes

This skill requires the agent-instruction CLI to be installed and available in PATH. The CLI manages rule files in the .agent-instruction/ directory and builds instruction files at the repository root.

平台分布

Codex

34.9%
按下载量换算22

Claude

32.58%
按下载量换算21

Cursor

19.73%
按下载量换算12

Gemini CLI

9.17%
按下载量换算6

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills