Agent skill

Axone Contributor Workflow

by axone-protocol in axone-protocol/axoned

Contribute safely to the AXONE axoned repository. An agent skill from axone-protocol/axoned.

Apache-2.0Auto-check passed

Install Axone Contributor Workflow

skills CLI
$ npx skills add axone-protocol/axoned --skill axone-contributor-workflow -a claude-code

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

GitHub CLI
$ gh skill install axone-protocol/axoned axone-contributor-workflow --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/axone-protocol/axoned.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/axone-contributor-workflow .claude/skills/axone-contributor-workflow && 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
axone-contributor-workflow
GitHub stars
176
Token cost
~830 tokens
SKILL.md length
355 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

Contribute safely to the AXONE axoned repository. An agent skill from axone-protocol/axoned.

  • Works in 5 steps: Read the touched files and the nearest… → Edit source files, not generated files,… → Use make targets as the only validation… → …
  • Changing Go code
  • SKILL.md covers Rules, Choose validation by change type, Gotchas and High-signal files to read first, plus 1 more section
  • Calls make and git

What it does

Axone Contributor Workflow is an agent skill from axone-protocol/axoned. Contribute safely to the AXONE axoned repository. Use when changing Go code, proto files, generated docs, predicate logic, tests, CI workflows, release plumbing, or local chain behavior in this repo. Applies the repo's validation steps, generation commands, and contributor-specific gotchas before finalizing changes.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires git, go, make, and docker. Node is only needed when validating generated markdown for MDX compatibility.

It works with Go. The repository describes itself as: ⛓️ Axone blockchain 💫. The licence is Apache-2.0.

When your agent uses it

  • Changing Go code
  • Predicate logic
  • Release plumbing
  • Local chain behavior in this repo

Example prompts

  • “/axone-contributor-workflow”

Requirements

  • Docker
  • Compatibility (from SKILL.md): Requires git, go, make, and docker. Node is only needed when validating generated markdown for MDX compatibility.

Workflow steps

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

  1. Read the touched files and the nearest build, generator, or CI entrypoint before editing.
  2. Edit source files, not generated files, unless there is no generator.
  3. Use make targets as the only validation interface.
  4. When several make targets could apply, prefer the broader one.
  5. Regenerate derived artifacts before finishing and inspect the final diff.

What it can do on your machine

Read from SKILL.md and the folder at commit 4780d35. 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:

    • make
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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.

  • Compatibility

    Requires git, go, make, and docker. Node is only needed when validating generated markdown for MDX compatibility.

    From compatibility in the SKILL.md frontmatter.

Context cost

Axone Contributor Workflow loads about 830 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 355 words of instructions outside code blocks.

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

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 axone-protocol/axoned at commit 4780d35, republished under its Apache-2.0 licence (© axone-protocol). 355 words, ~830 tokens.

Download SKILL.mdSave it as .claude/skills/axone-contributor-workflow/SKILL.md (or your agent's skills folder).
name
axone-contributor-workflow
description
Contribute safely to the AXONE axoned repository. Use when changing Go code, proto files, generated docs, predicate logic, tests, CI workflows, release plumbing, or local chain behavior in this repo. Applies the repo's validation steps, generation commands, and contributor-specific gotchas before finalizing changes.
compatibility
Requires git, go, make, and docker. Node is only needed when validating generated markdown for MDX compatibility.

Axone Contributor Workflow

Use this skill for routine contribution work in this repository. It is the default workflow for changes under app/, cmd/, proto/, scripts/, x/**, docs/, Makefile, and .github/workflows/.

Rules

  1. Read the touched files and the nearest build, generator, or CI entrypoint before editing.
  2. Edit source files, not generated files, unless there is no generator.
  3. Use make targets as the only validation interface.
  4. When several make targets could apply, prefer the broader one.
  5. Regenerate derived artifacts before finishing and inspect the final diff.

Choose validation by change type

  • Go code, imports, or dependencies: run make lint-go and make test-go.
  • Proto files: run make proto.
  • CLI command or Cobra flag changes: run make doc-command.
  • Predicate, Prolog library, bootstrap, or predicate feature changes: run make doc-predicate and make test-go.
  • Interface changes that affect mocks: run make mock.
  • App wiring, local chain behavior, or upgrades: run make build-go. For local chain validation, use make chain-init, make chain-start, and make chain-stop. For upgrade work, use make chain-upgrade FROM_VERSION=... TO_VERSION=....
  • Generated markdown under docs/: run the relevant generation target from Makefile. CI will additionally check MDX compatibility.
Show full SKILL.md (167 more words)Show less

Gotchas

  • Tests must follow the repo conventions: GoConvey is allowed, testify, ginkgo, and gomega are forbidden.
  • gofumpt is mandatory, but the correct entrypoint is still make lint-go.
  • CI regenerates command docs, proto docs, and predicate docs and fails on unexpected diffs.
  • make doc-command rewrites machine-specific defaults in generated markdown. Do not hand-edit those outputs afterward.
  • make proto-gen copies generated code back from github.com/axone-protocol/axoned/* into the repo root. Inspect the diff after regeneration.
  • make build-go-all is host-limited and can fail on cross-compilation mismatches. Prefer make build-go.
  • make chain-stop runs killall axoned.

High-signal files to read first

  • Makefile
  • .github/workflows/lint.yml
  • .github/workflows/test.yml
  • .golangci.yml
  • README.md

For subsystem-specific work, also read the closest source and generator entrypoints:

  • Predicate docs: scripts/generate_predicates_doc.go
  • Command docs: scripts/generate_command_doc.go
  • Proto generation: scripts/protocgen-code.sh and scripts/protocgen-doc.sh
  • Upgrade work: app/upgrades.go

Final self-check

  • The validation commands you ran match the change type.
  • Any generated file diffs are expected and trace back to source edits.
  • git status --short contains only intended files.
  • If go.mod or go.sum changed, they were updated intentionally and are tidy.

© axone-protocol, 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

Just SKILL.md in .agents/skills/axone-contributor-workflow of axone-protocol/axoned.

Open the folder on GitHubat commit 4780d35

Compare with similar skills

Axone Contributor Workflow 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.

Axone Contributor Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Axone Contributor Workflow this skillaxone-protocol/axoned176—~830Automated safety check: PassApache-2.0
Add Redis Command to go-redisredis/go-redis22k—~1.4kAutomated safety check: PassBSD-2-Clause
Go Pedantrychromedp/chromedp13k—~3.7kAutomated safety check: PassMIT
Fory Releaseapache/fory4.6k—~2.9kAutomated safety check: PassApache-2.0
AO Desktop App LauncherOrchestratorInc/agent-orchestrator13k—~2.4kAutomated safety check: PassApache-2.0
Go-Redis Release Preparationredis/go-redis22k—~1.1kAutomated safety check: PassBSD-2-Clause

Similar skills

  • Official

    Walks through adding a new Redis or Redis module command to the go-redis client, from fetching the spec and docs to the type, interface wiring, parsing and tests.

    22k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Go Pedantry

    chromedp/chromedp

    This skill should be used when the user is writing Go code and needs guidance on Go-specific pedantry: error wrapping with fmt.Errorf and %w, interface design (accept interfaces return structs)…

    13k GitHub stars~3.7k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Fory Release

    apache/fory

    Prepare an Apache Fory release candidate from a clean release branch, including the version bump, RC tag, JVM staging, ASF source artifacts, SVN upload, and vote email.

    4.6k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • AO Desktop App Launcher

    OrchestratorInc/agent-orchestrator

    Launches, restarts and troubleshoots the real AO Electron desktop app from a checkout, with isolated or real local data and checks for stale processes.

    13k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.

    22k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Starts a Dozzle dev server on a port derived from the current worktree so you can test by hand in a browser, without disturbing instances started elsewhere.

    15k GitHub stars~747 tokensUpdated today
    DevelopmentAuto-check passed

More from axone-protocol/axoned

  • Axone Proto Specification

    axone-protocol/axoned

    Design and evolve protobuf APIs for this repository. An agent skill from axone-protocol/axoned.

    176 GitHub stars~828 tokensUpdated yesterday
    Auto-check passed
  • Axone Logic Predicate

    axone-protocol/axoned

    Add or change predicates in the AXONE logic module. An agent skill from axone-protocol/axoned.

    176 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Axone Contributor Workflow

What does Axone Contributor Workflow do?

Contribute safely to the AXONE axoned repository. An agent skill from axone-protocol/axoned. Axone Contributor Workflow is an agent skill from axone-protocol/axoned. Contribute safely to the AXONE axoned repository.

When should I use Axone Contributor Workflow?

Axone Contributor Workflow fits situations like: changing Go code; predicate logic; release plumbing; local chain behavior in this repo.

How do I install Axone Contributor Workflow in Claude Code?

Run `npx skills add axone-protocol/axoned --skill axone-contributor-workflow -a claude-code`. Or copy the skill folder (.agents/skills/axone-contributor-workflow in axone-protocol/axoned) into .claude/skills/axone-contributor-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Axone Contributor Workflow in Codex?

Run `npx skills add axone-protocol/axoned --skill axone-contributor-workflow -a codex`. Or copy the skill folder (.agents/skills/axone-contributor-workflow in axone-protocol/axoned) into .agents/skills/axone-contributor-workflow in your project. Codex loads it when a task matches its description.

Can I use Axone Contributor Workflow 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 axone-protocol/axoned --skill axone-contributor-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/axone-contributor-workflow, .gemini/skills/axone-contributor-workflow, .github/skills/axone-contributor-workflow and .opencode/skills/axone-contributor-workflow in your project.

What does Axone Contributor Workflow need to run?

Going by SKILL.md and its folder, Axone Contributor Workflow needs the command-line tools its instructions call (make and git). Our summary lists: Docker. Compatibility (from SKILL.md): Requires git, go, make, and docker. Node is only needed when validating generated markdown for MDX compatibility..

Does Axone Contributor Workflow access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Axone Contributor Workflow 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 Axone Contributor Workflow use?

Axone Contributor Workflow 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 Axone Contributor Workflow use?

About 830 tokens (SKILL.md is roughly 3.3k 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 Axone Contributor Workflow?

Skills that share tags, products or a category with Axone Contributor Workflow: Add Redis Command to go-redis (redis/go-redis, 22k stars), Go Pedantry (chromedp/chromedp, 13k stars), Fory Release (apache/fory, 4.6k stars) and AO Desktop App Launcher (OrchestratorInc/agent-orchestrator, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Axone Contributor Workflow?

axone-protocol (a GitHub organization) maintains it in axone-protocol/axoned, which has 176 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 6, 2026.

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