Token导航 LogoToken导航TokenDH.com
中转站排行榜
开发执行命令github未标认证来源可访问许可证需确认审计通过

write-a-skill（写一个技能）

Agent Skill

write-a-skill 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

总安装

514

周安装

21

GitHub Stars

7

下载量

166
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

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

请帮我安装这个 Agent Skill：write-a-skill（写一个技能）
来源仓库：https://github.com/helderberto/skills
仓库路径：skills/write-a-skill
安装命令：
npx skills add https://github.com/helderberto/skills --skill write-a-skill
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

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

skills.shnpx skills
npx skills add https://github.com/helderberto/skills --skill write-a-skill

简介

write-a-skill 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合整理仓库状态和变更事项。

  • 适用于开发场景中需要围绕代码变更进行梳理的任务。
  • 通过 npx skills add 命令从 GitHub 安装，需确认权限范围和维护状态。
  • 使用前建议检查是否会触发联网、命令执行或文件读写操作。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

SKILL.md

Write a Skill

Process

  1. Clarify scope -- ask the user (use AskUserQuestion when available; otherwise present as numbered options):

- "What type of skill?" — Options: "Pure instructions (no scripts)", "Instructions + helper scripts", "Wrapper around CLI tool" - "Does it need pre-loaded context?" — Options: "Yes — auto-run commands on load (Recommended)", "No — gather context during workflow"

  1. Explore existing skills -- ls the skills repo, read similar skills for conventions
  2. Draft -- create SKILL.md
  3. Review with user -- confirm coverage, ask what's missing

Structure

skill-name/
├── SKILL.md              # Required. All instructions live here.
└── scripts/              # Optional. Executable helpers only.
    └── scan-secrets.sh

Keep everything in SKILL.md. Only use scripts/ for executable files (.sh,.py) that are called via Bash.

SKILL.md Template

---
name: skill-name
description: One sentence what it does. Use when [triggers]. Don't use when [anti-triggers].
---

# Skill Name

## Workflow
[numbered steps]

## Rules
[hard constraints]

## Error Handling
[if X -- do Y]

Frontmatter Fields

FieldRequiredNotes
nameyeskebab-case, matches directory
descriptionyesAgent's only signal for when to load this skill

Description Rules

The description is the only thing the agent sees when choosing which skill to load.

  • Max 1024 chars
  • First sentence: what it does
  • Second sentence: Use when [triggers]
  • Third sentence (optional): Don't use when [anti-triggers]

Good: Groups unstaged changes into atomic commits by concern. Use when user says "atomic commits" or wants to split changes before pushing. Bad: Helps with commits.

Examples

Minimal skill -- pure instructions, fits in ~20 lines:

---
name: grill-me
description: Interview the user relentlessly about a plan. Use when user says "grill me".
---

[instructions...]

Pre-loaded context -- ! prefix auto-runs commands on load:

## Pre-loaded context

- Status: !`git status`
- Diff: !`git diff HEAD`

Avoids wasting a turn fetching context the agent always needs.

Rules

  • No time-sensitive info (versions, dates) in skills
  • Include error handling for foreseeable failure modes
  • Test the skill by invoking it before shipping

Anti-patterns

  • Description without triggers: "Helps with testing." -- useless
  • Hardcoded versions or dates that go stale
  • No error handling for skills that run Bash commands

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Codex

36.56%
按下载量换算61

Claude

29.58%
按下载量换算49

Cursor

19.21%
按下载量换算32

Gemini CLI

10.01%
按下载量换算17

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

执行命令

安装流程涉及命令执行，可能通过 npx skills add https://github.com/helderberto/skills --skill write-a-skill 联网下载 Skill 或依赖。用户安装前应确认命令来源、仓库内容和执行环境。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/helderberto/skills

SKILL.md 来源

github.com

/helderberto/skills/tree/main/skills/write-a-skill

skills-sh

skills.sh

/helderberto/skills/write-a-skill

继续浏览同类 Skills

更多开发 Skills（21,746）返回 Skills 目录

上一个 Skill

write-a-skill（写一个技能）

write-a-skill 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

write-a-skill（写一个技能）

write-a-skill 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。