New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Editing Skills

by ZaxbyHub in ZaxbyHub/opencode-swarm

Contract for adding, editing, moving, or removing skills in this repository (.claude/skills, .opencode/skills, .agents/skills, any SKILL.md): mirror classifications in src/config/skill-mirrors.ts…

MITAuto-check passedAgent Workflows

Install Editing Skills

skills CLI
$ npx skills add ZaxbyHub/opencode-swarm --skill editing-skills -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZaxbyHub/opencode-swarm editing-skills --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZaxbyHub/opencode-swarm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/editing-skills .claude/skills/editing-skills && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
editing-skills
GitHub stars
494
Token cost
~2k tokens
SKILL.md length
901 words
Files
1
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Contract for adding, editing, moving, or removing skills in this repository (.claude/skills, .opencode/skills, .agents/skills, any SKILL.md): mirror classifications in src/config/skill-mirrors.ts…

  • Works in 5 steps: Classify the skill → Know what ships where → MODE skills are not triggered by… → …
  • Tasks that involve Skill authoring
  • SKILL.md covers Step 1 — Classify the skill, Step 2 — Know what ships where, Step 3 — MODE skills are not… and Step 4 — Frontmatter and…, plus 1 more section
  • Calls bun

What it does

Editing Skills is an agent skill from ZaxbyHub/opencode-swarm. Contract for adding, editing, moving, or removing skills in this repository (.claude/skills, .opencode/skills, .agents/skills, any SKILL.md): mirror classifications in src/config/skill-mirrors.ts, dual-tree byte-identical edits, bun run drift:check, bundling via BUNDLEDPROJECTSKILLS, frontmatter conventions, and how to write trigger descriptions. Load before touching any SKILL.md file.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: Architect-centric agentic swarm plugin for OpenCode. Hub-and-spoke orchestration with SME consultation, code generation, and QA review. The licence is MIT.

When your agent uses it

  • Tasks that involve Skill authoring

Example prompts

  • “/editing-skills”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Classify the skill
  2. Know what ships where
  3. MODE skills are not triggered by descriptions
  4. Frontmatter and description conventions
  5. Validate and publish

What it can do on your machine

Read from SKILL.md and the folder at commit b63a4bd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Editing Skills loads about 2k tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 901 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZaxbyHub/opencode-swarm at commit b63a4bd, republished under its MIT licence (© ZaxbyHub). 901 words, ~2,020 tokens.

Download SKILL.mdSave it as .claude/skills/editing-skills/SKILL.md (or your agent's skills folder).
name
editing-skills
description
Contract for adding, editing, moving, or removing skills in this repository (.claude/skills, .opencode/skills, .agents/skills, any SKILL.md): mirror classifications in src/config/skill-mirrors.ts, dual-tree byte-identical edits, bun run drift:check, bundling via BUNDLED_PROJECT_SKILLS, frontmatter conventions, and how to write trigger descriptions. Load before touching any SKILL.md file.
audience
swarm-plugin

Editing Skills in opencode-swarm

Skills in this repo exist across parallel trees (.opencode/skills/, .claude/skills/, .agents/skills/) governed by explicit mirror contracts. Editing a SKILL.md without knowing its contract silently desynchronizes the OpenCode and Claude Code surfaces. Classify first, then edit.

Step 1 — Classify the skill

Look the slug up in src/config/skill-mirrors.ts:

  • MIRRORED_ARCHITECT_MODE_SKILLS (brainstorm, specify, clarify-spec, swarm-resume, clarify, discover, consult, pre-phase-briefing, council, deep-dive, deep-research, issue-ingest, plan, critic-gate, design-docs): .opencode and .claude copies must stay byte-identical. Any edit is a dual-tree edit — apply the identical change to both files.
  • ADAPTER (execute, phase-wrap, swarm-pr-review, swarm-pr-feedback, swarm-pr-subscribe, swarm-ci-monitor): .opencode is canonical; .claude and .agents where present are thin shims that must keep the exact relative reference ../../../.opencode/skills/<slug>/SKILL.md (drift-check verifies the string). swarm-implement follows the same operational adapter pattern, but is currently classified as an additional divergent contract because the additional-contract registry does not yet model non-architect adapter shims.
  • DIVERGENT: both trees exist, content intentionally differs — a single-tree edit is fine. codebase-review-swarm is in DIVERGENT_ARCHITECT_MODE_SKILLS; engineering-conventions is a divergent entry in ADDITIONAL_SKILL_MIRROR_CONTRACTS. swarm-implement and writing-tests are classified divergent only because the additional-contract model does not yet have an adapter kind; operationally, .opencode is canonical and .claude delegates to it.
  • OPENCODE-ONLY: loop (OPENCODE_ONLY_ARCHITECT_MODE_SKILLS) and running-tests (an opencode-only ADDITIONAL contract) — do not create .claude mirrors (a .claude/skills/loop would shadow Claude Code's built-in /loop).
  • ADDITIONAL contracts: commit-pr is divergent (#1692). The .claude copy is the repo-INTERNAL publication protocol (CI's pr-standards workflow declares it the source of truth); the .opencode copy is the PORTABLE, project-agnostic version bundled into end-user projects, so the two trees intentionally differ — do not sync them byte-for-byte. The discovery shims in .agents/skills/commit-pr/ and .github/skills/commit-pr/ point at the repo-internal .claude file as canonical.
  • Adapter skills (issue-tracer): .opencode/skills/<slug>/SKILL.md is the canonical protocol; .claude/skills/<slug>/SKILL.md and .agents/skills/<slug>/SKILL.md are thin shims that reference it via the relative path. See src/config/skill-mirrors.ts for the kind: adapter contract.
  • No skill-mirrors.ts entry (qa-sweep, research-first, swarm, unswarm, tech-debt-ci-review, rust-crate-ci, orchestrating-subagents, durable-session-state, editing-skills, …): the .claude file is the source protocol and there is no .opencode copy, no CI gate, and no npm shipment. But most are not single-file: many have a Codex adapter shim in .agents/skills/<slug>/ that reads ".claude/skills/<slug>/SKILL.md is the source protocol" (check ls .agents/skills/). Content edits to the .claude file are safe — shims delegate — but renaming, moving, or removing one of these skills silently orphans its .agents shim with zero drift-check coverage. Update or remove the shim in the same change.
  • Pre-flight for new skills (blocking): Before authoring any SKILL.md content for a skill that should reach npm users, the slug MUST be registered in all three places: src/config/skill-mirrors.ts (classification), src/config/bundled-skills.ts (BUNDLED_PROJECT_SKILLS), and package.json#files. Creating content first and registering later is a common source of drift-check failures and missing shipments.

Step 2 — Know what ships where

  • Only canonical package sources under .opencode/skills/ are published: package.json#files lists the bundled source directories and BUNDLED_PROJECT_SKILLS (src/config/bundled-skills.ts) drives a private runtime sync to .swarm/bundled-skills/<slug>/ at plugin init. Never sync into a target project's native skill roots.
  • .claude/skills/ is repo-internal — it configures Claude Code sessions in this repository only.
  • A new skill that should reach npm users must be added to all three: .opencode/skills/<slug>/, BUNDLED_PROJECT_SKILLS, and package.json#files — the drift checker flags incomplete combinations.
  • A new cross-tree pair (same slug in both trees) must be classified in src/config/skill-mirrors.ts, or drift-check reports it "unclassified".
Show full SKILL.md (359 more words)Show less

Step 3 — MODE skills are not triggered by descriptions

The mirrored architect skills carry descriptions like "Full execution protocol for MODE: PLAN". These are loaded on demand by the architect stubs in src/agents/architect.ts when a [MODE: …] signal fires — they are not meant to match natural user language, and in a plain Claude Code session (no swarm runtime tools) they are protocol documentation, not executable workflows. Do not "fix" their descriptions to natural language, and do not expect them to auto-trigger.

Step 4 — Frontmatter and description conventions

  • Every tracked static skill declares audience: swarm-plugin. Consumer repos may instead use a domain tag such as ragappv3 and optionally add a runner constraint (runner:opencode, runner:claude, or runner:codex). Keep byte-identical mirrors' audience lines byte-identical. Runtime-generated skills are intentionally allowed to omit the field (legacy match-all).
  • description is how Claude Code auto-selects skills: third person, the core use case and concrete trigger keywords first, under ~1024 chars. Vague descriptions ("helps with X") never trigger.
  • disable-model-invocation: true for slash-command-style skills the model must not self-invoke (swarm, unswarm, tech-debt-ci-review).
  • Supported optional fields used in this repo: effort (low…max), context: fork + agent: Explore|Plan|general-purpose|<custom> (runs the skill body in an isolated subagent — the body then cannot rely on conversation history or on spawning further subagents), allowed-tools (space- or comma-separated), argument-hint.
  • Keep SKILL.md under ~500 lines; move deep material into references/ files linked one level from the SKILL.md (see issue-tracer for the pattern).

Step 5 — Validate and publish

  1. If the edit changed content wording (not just whitespace/formatting), read file:.swarm/bundled-skills/skill-edit-validation/SKILL.md and run its content-assertion sweep to catch stale test assertions before proceeding.
  2. bun run drift:check --enforce — CI runs the same enforcement mode; blocking drift findings fail the job, while the full report is posted as a PR comment.
  3. If you touched a byte-identical pair, diff the two files to prove identity.
  4. Skill-only diffs (no src/, scripts/, or test changes) count as docs/meta-only for PR gating — no release-notes fragment required. The moment you also touch src/config/skill-mirrors.ts, bundled-skills.ts, or package.json, a docs/releases/pending/<slug>.md fragment becomes mandatory (see commit-pr skill, Step 2).
  5. Skill edits are still "changed work" under the swarm-mode contract: independent reviewer + critic gates apply before completion.

© ZaxbyHub, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/editing-skills of ZaxbyHub/opencode-swarm.

Open the folder on GitHubat commit b63a4bd

Compare with similar skills

Editing Skills next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Editing Skills compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Editing Skills this skillZaxbyHub/opencode-swarm494—~2kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed

  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed

  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed

  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed

  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed

  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    67k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from ZaxbyHub/opencode-swarm

All 91 skills in this repo

  • Codebase Review Swarm

    ZaxbyHub/opencode-swarm

    Runs an evidence-gated, quote-grounded audit of a codebase for security, QA, accessibility, performance and more, and writes a verified report without changing source files.

    496 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

  • Issue Tracer

    ZaxbyHub/opencode-swarm

    Drives a bug report from validation and root-cause tracing through a critic-reviewed plan, an approved minimal fix and a PR-ready closure, never merging without recorded human approval.

    496 GitHub stars~4.4k tokensUpdated today
    Auto-check passed

  • Commit and PR Publishing for Codex

    ZaxbyHub/opencode-swarm

    Codex adapter for opencode-swarm that governs commits, pushes, draft PRs, PR body updates and CI closeout, deferring to the repo's canonical commit-pr protocol.

    496 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Durable Session State

    ZaxbyHub/opencode-swarm

    Keeps plans, decisions, evidence and reviewer verdicts in small files so long multi-phase tasks survive context compaction and session resumes.

    496 GitHub stars~896 tokensUpdated today
    Auto-check passed

  • Swarm PR Feedback Closer

    ZaxbyHub/opencode-swarm

    Ingests existing pull request feedback such as review comments and CI failures, verifies each claim, fixes confirmed issues and reports closure status for every item.

    496 GitHub stars~14k tokensUpdated today
    Auto-check passed

  • Swarm PR Subscribe

    ZaxbyHub/opencode-swarm

    Monitor a pull request after creation and act autonomously on pushed PR activity.

    496 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Editing Skills

What does Editing Skills do?

Contract for adding, editing, moving, or removing skills in this repository (.claude/skills, .opencode/skills, .agents/skills, any SKILL.md): mirror classifications in src/config/skill-mirrors.ts…. Editing Skills is an agent skill from ZaxbyHub/opencode-swarm.ts, dual-tree byte-identical edits, bun run drift:check, bundling via BUNDLEDPROJECTSKILLS, frontmatter conventions, and how to write trigger descriptions.

When should I use Editing Skills?

Editing Skills fits situations like: tasks that involve Skill authoring.

How do I install Editing Skills in Claude Code?

Run `npx skills add ZaxbyHub/opencode-swarm --skill editing-skills -a claude-code`. Or copy the skill folder (.claude/skills/editing-skills in ZaxbyHub/opencode-swarm) into .claude/skills/editing-skills in your project. Claude Code loads it when a task matches its description.

How do I install Editing Skills in Codex?

Run `npx skills add ZaxbyHub/opencode-swarm --skill editing-skills -a codex`. Or copy the skill folder (.claude/skills/editing-skills in ZaxbyHub/opencode-swarm) into .agents/skills/editing-skills in your project. Codex loads it when a task matches its description.

Can I use Editing Skills in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZaxbyHub/opencode-swarm --skill editing-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/editing-skills, .gemini/skills/editing-skills, .github/skills/editing-skills and .opencode/skills/editing-skills in your project.

What does Editing Skills need to run?

Going by SKILL.md and its folder, Editing Skills needs the command-line tools its instructions call (bun).

Does Editing Skills access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Editing Skills safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Editing Skills use?

Editing Skills is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Editing Skills use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Editing Skills?

Skills that share tags, products or a category with Editing Skills: Skill Creator (Azure/azqr, 796 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Editing Skills?

ZaxbyHub (a GitHub organization) maintains it in ZaxbyHub/opencode-swarm, which has 494 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on October 10, 2026.

Source: ZaxbyHub/opencode-swarm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.