Agent skill

Skill Builder

by boshu2 in boshu2/agentops

Create, repair, audit or consolidate agent skills (SKILL.md packages).

Apache-2.0Auto-check passedAgent Workflows

Install Skill Builder

skills CLI
$ npx skills add boshu2/agentops --skill skill-builder -a claude-code

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

GitHub CLI
$ gh skill install boshu2/agentops skill-builder --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/boshu2/agentops.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-builder .claude/skills/skill-builder && 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
skill-builder
GitHub stars
447
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
907 words
Files
33 (incl. scripts, references)
Skills in repo
31
Repo updated
First seen
Licence
Apache-2.0

At a glance

Create, repair, audit or consolidate agent skills (SKILL.md packages).

  • Works in 5 steps: Find the existing owner. Search skills,… → Count independent occurrences. A new… → Name the consumer of every new artifact.… → …
  • Its description
  • SKILL.md covers Decide whether to create…, Choose the requested operation, Create and maintain and Conversion, plus 1 more section
  • Runs Shell scripts from its folder

What it does

Skill Builder is an agent skill from boshu2/agentops. Create, repair, audit or consolidate agent skills (SKILL.md packages). Use when: writing or fixing a skill, its description or structure. Not for one-off lessons; use Memory.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 36 other files, including scripts and reference files (for example `references/audit-checks.md`, `references/authoring-doctrine.md` and `references/build-mechanics.md`).

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: DevOps discipline for AI coding agents: shape the work, track it as a graph, and get each change judged by a context that didn't write it. The licence is Apache-2.0.

When your agent uses it

  • Its description
  • Tasks that involve Skill authoring

Example prompts

  • “/skill-builder”

Requirements

  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Find the existing owner. Search skills, references, checklists and
  2. Count independent occurrences. A new skill, gate, library or workflow
  3. Name the consumer of every new artifact. A proposed process artifact
  4. No action is a valid result, and so is a short addition to an existing
  5. A built package proves no benefit. Route behavioral benefit to

What it can do on your machine

Read from SKILL.md and the folder at commit 3bdbfed. 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

    Ships 2 files in scripts/ (Shell, from the files we listed), which the agent can run.

    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

Skill Builder loads about 2k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 907 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from boshu2/agentops at commit 3bdbfed, republished under its Apache-2.0 licence (© boshu2). 907 words, ~2,011 tokens.

Download SKILL.mdSave it as .claude/skills/skill-builder/SKILL.md (or your agent's skills folder). This skill also uses 32 other files; get the full folder from GitHub.
name
skill-builder
description
Create, repair, audit or consolidate agent skills (SKILL.md packages). Use when: writing or fixing a skill, its description or structure. Not for one-off lessons; use Memory.
practices
pragmatic-programmer, refactoring
hexagonal_role
supporting
produces
skill-source-package, skill-hygiene-report, converted-skill, operationalization-proposal
skill_api_version
1
user-invocable
true
context.window
fork
metadata.capabilities
skill_builder, heal_skill, export_skill, distill_expertise
metadata.effects
write_skill_source, write_build_report, regenerate_skill_projections, repair_skill_projections, write_converted_skill_projection, write_advisory_proposal
metadata.canonical_status
canonical
metadata.disposition
keep_specialist

Skill Builder

Create, repair, audit or export one canonical skill package, or turn supported expertise into a small authoring proposal.

Decide whether to create anything

Apply these before any creation step, including when the request already names the new skill or file it wants:

  1. Find the existing owner. Search skills, references, checklists and instruction files for one that already handles the behavior. Extend that owner rather than adding a root.
  2. Count independent occurrences. A new skill, gate, library or workflow needs three independently evidenced real occurrences and a successful reapplication to a source case without missing context. Fewer occurrences support only a narrow note in an existing owner; one incident is an observation, not a skill. An authoritative source supports only a faithful statement of that source.
  3. Name the consumer of every new artifact. A proposed process artifact (a report, ledger, counter, dashboard or tracker) needs a concrete consumer, the decision it informs, the observed defect it answers and a retirement condition. If any is missing, leave it out; code written only to consume it is no consumer.
  4. No action is a valid result, and so is a short addition to an existing owner. Say what the evidence supports before drafting, build only what the caller then authorizes, and return a proposal inline unless a durable one was requested.
  5. A built package proves no benefit. Route behavioral benefit to Skill Eval and acceptance judgment to Validate.

Choose the requested operation

NeedEntry point
Create a source packagescripts/build.sh with from-scratch, from-template or absorb-external
Check package structurescripts/heal.sh --check [--strict] skills/<slug>
Repair owned projectionsscripts/heal.sh --fix skills/<slug>
Inspect audit evidence`scripts/audit.sh [--profile canonical
Export to another platformConversion
Make repeated expertise reusableDistill expertise

Run only the selected operation. Skills remain optional tools within the native caller's authorized outcome; this skill does not add execution phases, own work, operate Git, validate a software candidate, or decide delivery and retries. Inputs, report destinations, exit codes and recovery from partial creation are in build and check mechanics.

Create and maintain

Treat external skills as structural signals only. Clean-room output must not copy their names, prose, prompts, scripts or examples. from-template reuses metadata defaults; absorb-external <slug> --from <path> verifies an input and creates a blank source package. Neither imports another skill's content.

scripts/build.sh creates one incomplete source package containing only SKILL.md with metadata.authoring_state: scaffold; helpers, references and assets are conditional on the actual behavior. Replace the placeholders and state applicability, inputs, authority, result, completion and failure in the layout that makes them clear. Remove the scaffold state only after authoring the behavior; strict source checks reject it. Removing it is an author assertion, not proof of semantic completeness.

Edit skills/<slug>/ as the source owner. Check the completed source with scripts/heal.sh --check --strict skills/<slug>, then regenerate its owned projections through the repository's owning commands. Inspect the generated diff; hand-edit no projection.

Creation is staged, not atomic. If a later stage fails, keep the created source and any report, capture the exit and diagnostic, and report source creation separately from projection and check completion. Never call a partial result a completed package or delete it to rerun creation. Missing required scripts, references or runtime support block only their dependent operation; name that resource and continue work that does not depend on it.

Check mode is read-only; fix mode regenerates owned projections for explicit targets and invents no source behavior. The default audit reports static conformance, located effects, behavioral evidence and non-gating authoring suspicions separately, with no total, rating or aggregate verdict. Effects and behavior stay NOT_PROVEN because the audit runs no skill or trial. Exact checks, exit codes and the opt-in legacy schema live in audit checks, authoring doctrine and Codex parity.

Show full SKILL.md (283 more words)Show less

Conversion

Use bash skills/skill-builder/scripts/converter/convert.sh <skill-dir> <target> [output-dir] for an explicit out-of-tree export. Targets are codex, cursor and test; --all selects all source packages, and --codex-layout inline selects the legacy inline Codex layout. Read SkillBundle when format details matter. Parse the source once, render the target, then validate resource parity and target format. Report layout and any omitted Cursor references.

The default export is .agents/projections/converter/<target>/<skill-name>/. The exporter clean-writes its output directory, so use only the explicit derived target: refuse a source package, its ancestor, or the repository root. Preserve the source unchanged and fix the source or adapter instead of editing output. A parse, write, format or required-resource failure leaves an incomplete export. Every runtime, Codex included, loads skills/ directly; this ad-hoc exporter never produces a shipped tree.

Distill expertise

When the caller wants a reusable rule, apply the decision rules above, then begin with cited occurrences or a named authoritative source. State the trigger, desired behavior, inputs, outputs, negative example and limits. Preserve short source excerpts or command results with resolvable citations. Use Research's pattern mode when the claim needs exemplars and a holdout before packaging. Show a negative or holdout case and how the proposed rule returns the right decision. Minimal recovery state needs a named evidence-loss or corruption risk.

Respect Memory's source and destination rules for mined material. Evidence cannot publish itself as policy. A proposal-only request ends with the proposal. Repair ordinary known defects within existing authority; tool failures remain explicit facts for the native caller, not an automatic helper chain.

For an actual package edit, use the source template for required fields and context density guidance when deciding which prose earns a place. Neither requires adding a new skill.

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

Files

SKILL.md and 32 other files (scripts, references) in skills/skill-builder of boshu2/agentops.

  • SKILL.md
  • references/audit-checks.md
  • references/authoring-doctrine.md
  • references/build-mechanics.md
  • references/codex-parity.md
  • references/context-density-checks.md
  • references/converter/skill-bundle-schema.md
  • references/heal.feature
  • references/skill-auditor.feature
  • references/skill-builder.feature
  • references/skill-conformance-profiles.yaml
  • references/skill-template.md
  • schemas/audit-report-legacy.json
  • schemas/audit-report.json
  • schemas/build-report.json
  • scripts/audit-legacy.sh
  • scripts/audit.sh
  • … and 16 more

Open the folder on GitHubat commit 3bdbfed

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in boshu2/agentops, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Skill Builder 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.

Skill Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Builder this skillboshu2/agentops4471 repos~2kAutomated safety check: PassApache-2.0
Skill CreatorAzure/azqr79589 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.

    795 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.

    66k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from boshu2/agentops

All 31 skills in this repo
  • Agent Native

    boshu2/agentops

    Dispatch independent tasks to parallel workers or subagents without write collisions.

    447 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Council

    boshu2/agentops

    Compare independent opinions from several models or contexts without inflating agreement.

    447 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Craft Goal

    boshu2/agentops

    Draft or lint a bounded long-running goal prompt with a finish line and hard limits.

    447 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Doc

    boshu2/agentops

    Write or update READMEs, docs, repo instructions and handoff notes, checked against source.

    447 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Idea Genie

    boshu2/agentops

    Brainstorm evidence-backed options for what to build, or stress-test an idea.

    447 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Implement

    boshu2/agentops

    Change or repair code, config or services without weakening tests; report what ran and what did not.

    447 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed

Categories

Questions about Skill Builder

What does Skill Builder do?

Create, repair, audit or consolidate agent skills (SKILL.md packages). Skill Builder is an agent skill from boshu2/agentops.md packages).

When should I use Skill Builder?

Skill Builder fits situations like: its description; tasks that involve Skill authoring.

How do I install Skill Builder in Claude Code?

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

How do I install Skill Builder in Codex?

Run `npx skills add boshu2/agentops --skill skill-builder -a codex`. Or copy the skill folder (skills/skill-builder in boshu2/agentops) into .agents/skills/skill-builder in your project. Codex loads it when a task matches its description.

Can I use Skill Builder 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 boshu2/agentops --skill skill-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-builder, .gemini/skills/skill-builder, .github/skills/skill-builder and .opencode/skills/skill-builder in your project.

What does Skill Builder need to run?

Going by SKILL.md and its folder, Skill Builder needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Skill Builder 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 Skill Builder 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Skill Builder use?

Skill Builder is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Builder use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.6k tokens, read only when the agent opens those files.

What are the alternatives to Skill Builder?

Skills that share tags, products or a category with Skill Builder: Skill Creator (Azure/azqr, 795 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 Skill Builder?

boshu2 (a GitHub user) maintains it in boshu2/agentops, which has 447 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 7, 2026.

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