skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
wilbeibi/wilbeibi-skills76 installs

write-skill

Author or update compact agent skills under skills/<name>/SKILL.md. Use when asked to write, add, or change a skill; not to audit a skill library.

How do I install this agent skill?

npx skills add https://github.com/wilbeibi/wilbeibi-skills --skill write-skill
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The write-skill is a benign utility designed to scaffold new agent skills. It provides a structured process for developers to define new capabilities and generates the necessary markdown files. It contains no malicious code or unauthorized access patterns.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

write-skill

Create compact skills under skills/<name>/ that load only the behavior needed at invocation time.

Workflow

  1. Clarify only missing essentials: capability, triggers, non-triggers, tool/script needs, and portability.
  2. Pick a unique kebab-case name.
  3. Draft SKILL.md as an operator card: what to run, when to run it, what output means, what traps matter.
  4. Add helper files only when they remove repeated deterministic work.
  5. Compress once; add one README row; do not commit unless asked.

Template

---
name: <kebab-case>
description: <Concrete capability.> Use when <real phrases, file types, tools, or contexts>. Do NOT use <negative triggers if broad>.
---

# <name>

<One-line operational contract.>

## Usage / Commands / Routing

```bash
scripts/tool_or_helper.py <arg>
```

## Notes

- <What output shape means, or how to consume it.>
- <Hard rule, setup failure, safety boundary, or common mistake.>

Description

The description is the routing surface; optimize it first.

  • Use 1-3 sentences, third person, present tense.
  • Sentence 1 names the concrete capability.
  • Sentence 2 starts with Use when ... and lists actual trigger phrases, file types, tools, or contexts.
  • Add Do NOT use ... for broad domains such as review, search, docs, macOS, git, or browser work.
  • Avoid marketing words, time-sensitive claims, and duplicate "this skill should be used when" phrasing.

Body

Keep:

  • runnable commands or exact workflow steps;
  • setup checks that commonly block first use;
  • compact output contracts;
  • routing boundaries and safety pitfalls;
  • one strong example per command or concept.

Delete:

  • overview prose that restates the description;
  • installation/contributing/privacy/troubleshooting sections unless they change agent behavior;
  • copied CLI help, schemas, flag catalogs, or generated docs;
  • repeated prompt examples and canned analyses;
  • detail already present in README, references, or helper scripts.

Tool Skills

  • Put deterministic work in scripts/ or the existing executable.
  • Make SKILL.md a menu of invocations plus output shape and gotchas.
  • Use Run <tool> --help for all flags; keep only non-obvious flags.
  • Prefer 30-60 lines. If setup is long, keep the readiness check inline and move walkthroughs one hop away.

Workflow Skills

  • Keep the lens, decision order, and output contract.
  • Avoid rigid full templates unless structure is the skill's core value.
  • Findings should lead for review skills; summaries and praise are optional.
  • Split philosophy, examples, and source notes into references/REFERENCE.md. Keep examples inline when the example is the instruction, as in an output-shape skill.

Targeting

Shared skills target Codex, Claude Code, and Pi. Keep task knowledge, acceptance criteria, and executable helpers shared. Prefer existing CLIs for repeatable operations. Isolate harness-specific behavior only where required, and declare its dependency explicitly. Do not prescribe another harness's tool names, subagent APIs, or compaction mechanism.

Keep names/descriptions brief and task-specific. Model-specific corrections belong in local settings or a relevant reference, supported by an observed failure rather than a universal rule. Use detailed sequences where order or safety matters; otherwise describe the outcome and boundaries.

When the user chooses explicit-only activation, use disable-model-invocation: true in frontmatter for Claude/Pi and policy.allow_implicit_invocation: false in agents/openai.yaml for Codex. Preserve existing metadata and local overrides. Invocation controls do not grant action permissions. Keep automatically useful operational skills discoverable; require approval at the actual restricted action.

Cross-skill pointers: a negative one (Do NOT use for charts (use dataviz)) degrades harmlessly where the named skill is absent; a positive one (run X first) dangles, so those must name a skill in skills/.

Final Check

  • Name is unique kebab-case.
  • Description has concrete Use when ... triggers and needed Do NOT use ... boundaries.
  • SKILL.md is under ~120 lines, preferably 30-60 for tool wrappers.
  • Helpers are invoked, not duplicated in prose.
  • Positive cross-skill pointers name a skill that exists in skills/.
  • Agent- or OS-only requirements are declared in compatibility:, not worked around.
  • Update the existing catalog row if the skill's purpose or invocation changes.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/wilbeibi/wilbeibi-skills/write-skill">View write-skill on skillZs</a>