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

Arandu Feature

by arandu-io in arandu-io/arandu

Start here for any change to an Arandu (Go) application that adds or changes behaviour -- "add invoices", "let users publish a post", "send a weekly report", "call the payment provider", "expose…

MITAuto-check passedAgent Workflows

Install Arandu Feature

skills CLI
$ npx skills add arandu-io/arandu --skill arandu-feature -a claude-code

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

GitHub CLI
$ gh skill install arandu-io/arandu arandu-feature --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/arandu-io/arandu.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/arandu-feature .claude/skills/arandu-feature && 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
arandu-feature
GitHub stars
281
Token cost
~2.5k tokens
SKILL.md length
1,100 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Start here for any change to an Arandu (Go) application that adds or changes behaviour -- "add invoices", "let users publish a post", "send a weekly report", "call the payment provider", "expose…

  • Works in 4 steps: Read AGENTS.md whole: the anatomy table,… → Read the example the steps point at. The… → Answer the ownership questions in… → …
  • Tasks that involve REST APIs
  • SKILL.md covers When to use, Before you start, Contracts and imports and Procedure, plus 8 more sections
  • Calls go and bash

What it does

Arandu Feature is an agent skill from arandu-io/arandu. Start here for any change to an Arandu (Go) application that adds or changes behaviour -- "add invoices", "let users publish a post", "send a weekly report", "call the payment provider", "expose this to an assistant", "add an API endpoint". It classifies the feature, walks the anatomy and the "where each kind of code lives" table in AGENTS.md, picks the aru generators, says what to wire by hand and what to test, and names the family skill for each step. Use it before writing any file.

Its SKILL.md is about 2.5k 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 REST APIs, Forms and invoices and Agent instruction files. It works with GitHub and Go. The repository describes itself as: The Arandu project skeleton, which aru new clones. The licence is MIT.

When your agent uses it

  • Tasks that involve REST APIs
  • Tasks that involve Forms and invoices
  • Tasks that involve Agent instruction files

Example prompts

  • “add invoices”
  • “let users publish a post”
  • “send a weekly report”
  • “/arandu-feature”

Workflow steps

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

  1. Read AGENTS.md whole: the anatomy table, the "Where each kind of code
  2. Read the example the steps point at. The notes resource is the whole
  3. Answer the ownership questions in arandu-ecosystem before any table: a
  4. If the client can start aru mcp, connect it (arandu-mcp): its

What it can do on your machine

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

    • go
    • bash

    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

Arandu Feature loads about 2.5k tokens when it runs. Until then it costs about 126 tokens; SKILL.md has 1,100 words of instructions outside code blocks.

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

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 arandu-io/arandu at commit b8a4273, republished under its MIT licence (© arandu-io). 1,100 words, ~2,486 tokens.

Download SKILL.mdSave it as .claude/skills/arandu-feature/SKILL.md (or your agent's skills folder).
name
arandu-feature
description
Start here for any change to an Arandu (Go) application that adds or changes behaviour -- "add invoices", "let users publish a post", "send a weekly report", "call the payment provider", "expose this to an assistant", "add an API endpoint". It classifies the feature, walks the anatomy and the "where each kind of code lives" table in AGENTS.md, picks the aru generators, says what to wire by hand and what to test, and names the family skill for each step. Use it before writing any file.
license
MIT

Building a feature

When to use

Any request that adds or changes what the application does. It is the entry to the other skills: it decides the shape of the feature, and each step names the family skill that holds that step's rules. A one-line fix inside code that already exists goes straight to the family skill of that code.

Before you start

  1. Read AGENTS.md whole: the anatomy table, the "Where each kind of code lives" table and "What does not exist here".
  2. Read the example the steps point at. The notes resource is the whole anatomy in this repository: a model with a transition, a nested resource, a named action, a JSON Resource, an event with a listener, a notification, a scheduled job and an external client. .agents/skills/notes maps it.
  3. Answer the ownership questions in arandu-ecosystem before any table: a module of the ecosystem may already own the capability.
  4. If the client can start aru mcp, connect it (arandu-mcp): its feature_recipe and where_does_it_go answer steps 1 to 3 below from the contract of the pinned aru, and generate previews a generator before it writes.

Contracts and imports

Each symbol has one import path, and aru imports:catalog prints it for the framework version in go.mod:

whatimport
Grant, Subject, Authorize, Tenant, SystemGrantgithub.com/arandu-io/hesape/auth
Context, the argument of every actiongithub.com/arandu-io/hesape/http
Router, Indexer and the other resource interfaces, Invokergithub.com/arandu-io/framework/http
the route guards, RequireToken, Idempotentgithub.com/arandu-io/framework/http/middleware
validation.Errors, Validatablegithub.com/arandu-io/hesape/validation
database.DB, database.Transactiongithub.com/arandu-io/hesape/database

Procedure

1. Classify the feature. Write down which of these it is; most are two or three at once.

the featureits first stepfamily skill
a new kind of record, with a tablearu make:modulearandu-module
a record that lives under anotheraru make:module --parent=<resource>arandu-module, arandu-http
a verb beyond CRUD on a record: publish, approve, cancela rule in the entity, aru make:controller --actionarandu-module, arandu-http
a screen or a part of onea view, and maybe a partialarandu-view
an answer to a program rather than a personaru make:resourcearandu-api
work after the response, on a schedule or in reaction to a factaru make:job, aru make:event, aru make:listener, aru make:notificationarandu-async
a call to another system, a webhook, an assistantaru make:client, aru make:mcp-toolarandu-integrations
who may do itthe policyarandu-policy
roles, balances, tags, Markdown, API docsa module of the ecosystemarandu-ecosystem

2. Walk the anatomy in order, skipping the steps the feature does not have: specification, migration, model and its rules, factory and seeder, policy, request, service, controller, routes, view or resource, tests and wiring. The order is the order of dependence: each step compiles against the one before.

3. Put each piece where the table says. A rule of the entity in the model's custom block, the order of a use case in the service, input conversion in the controller, the answer in a view or a JSON Resource. A piece that seems to belong in two rows belongs in the one that does not need the other's collaborators.

4. Generate, then finish by hand. Every generator prints its wiring and edits neither bootstrap/app.go nor routes/web.go. Paste what it printed, read it, and write what it could not know in the custom blocks.

5. Test the path. A feature test that drives the feature the way its caller does, the tenant isolation of every new table, and the answers the family skill lists under "Acceptance test".

6. Report what is missing. A capability the framework or the generators do not have is a gap to name in the report, with the file that would have used it -- never a second way written in the application to cover it.

Commands

stepcommand
specificationaru schema, aru generate <spec.yaml> --check, aru generate <spec.yaml>
a whole resourcearu make:module <name> --fields "..." --tenant [--parent=<resource>]
one artifactaru make:model, aru make:migration, aru make:policy, aru make:request, aru make:service, aru make:controller, aru make:resource, aru make:job, aru make:event, aru make:listener, aru make:notification, aru make:client, aru make:mcp-tool, aru make:command, aru make:enum, aru make:mail, aru make:middleware, aru make:factory, aru make:seeder, aru make:test
the generated queryaru model:build
the viewsaru view:build
what is wiredaru route:list, aru schedule:list, aru about
the architecture checkaru doctor

aru <command> --help prints its usage line with every flag it takes.

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

Example

Every step of a feature leaves an artifact the next step relies on, and the compiler holds each of them to its contract. This file is the checklist of the example's steps, written as the assertions the compiler checks:

go
package feature

import (
	fhttp "github.com/arandu-io/framework/http"
	"github.com/arandu-io/hesape/auth"
	hevents "github.com/arandu-io/hesape/events"
	hhttp "github.com/arandu-io/hesape/http"
	"github.com/arandu-io/hesape/queue"
	"github.com/arandu-io/hesape/validation"

	clients "<module>/app/Clients"
	controllers "<module>/app/Http/Controllers"
	requests "<module>/app/Http/Requests"
	resources "<module>/app/Http/Resources"
	appjobs "<module>/app/Jobs"
	listeners "<module>/app/Listeners"
	models "<module>/app/Models"
	policies "<module>/app/Policies"
)

// The notes feature, step by step.
var (
	_ auth.Policy[models.Note] = policies.NotePolicy{}              // the policy
	_ validation.Validatable   = requests.NoteRequest{}             // the request
	_ fhttp.Indexer            = (*controllers.NoteController)(nil) // the controller
	_ fhttp.Indexer            = (*controllers.CommentController)(nil)
	_ hhttp.JsonResource       = resources.NoteResource{}               // the answer to a program
	_ hevents.Publisher        = (*listeners.NotifyNoteAuthor)(nil)     // the reaction to note.published
	_ queue.Handler            = (*appjobs.SendNotesDigestHandler)(nil) // the nightly job
	_ clients.Newsletter       = (*clients.NewsletterClient)(nil)       // the external system
	_ clients.Newsletter       = (*clients.NewsletterFake)(nil)         // and its fake
	_                          = (*models.Note).Publish                 // the transition is the entity's
)

Do not

  • Start from the controller. A controller written first grows the rules the entity and the service should hold, because it is the only file there is.
  • Reach for what another framework would use: a service container, a facade, a routes file per audience, a base controller with validate(). AGENTS.md says what is here instead.
  • Write a second way to do what exists. A local role table, a balance column, an HTTP call from a service, a JSON encoder in a controller -- each has an owner in the table.

Extending it

What a generator does not cover is written between // arandu:begin custom and // arandu:end custom in the file it wrote, and survives the next run with --force. A file finished by hand outside those markers -- as the example's controller is -- is changed by hand from then on, and its skill says so.

Wiring

All of it is by hand, in two files, from what the generators print:

  • bootstrap/app.go builds every collaborator once, in Build, and hands it down: services to controllers, the notifier to listeners, the clients to services, the queue to the provider that schedules.
  • routes/web.go holds the field on Deps and the route lines, in the custom block, behind the guard the route needs.
  • bootstrap/background.go registers job handlers; app/Providers declares scheduled tasks; routes/console.go declares commands.

Acceptance test

The feature is done when:

  1. a feature test drives it as its caller does -- a browser through tests.SignedIn, a JSON client with Accept: application/json, the scheduler through RunNow, the relay through Drain;
  2. every new table with tenant_id is claimed in tests/Feature/TenantScope_test.go and has a cross-tenant test that reads and writes;
  3. the gates below pass, with aru doctor reporting nothing new.

Limits

This skill orders the work; it does not hold the rules of any step. Where a family skill and this one seem to disagree, the family skill is right about its step. Where a generator, a family skill and the code disagree, the code is right and the other two are wrong -- report it.

Gates

Run them all, in this order, as AGENTS.md lists them:

sh
export GOWORK=off
aru model:build --check
aru view:build
gofmt -l $(find . -name '*.go' -not -path '*/testdata/*' -not -name '*.kyse.go')
go vet ./...
bash tests/test-layout-guard.sh
go test -race ./...
go build ./...
aru doctor
<!-- arandu:begin custom -->
<!-- arandu:end custom -->

© arandu-io, 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 .agents/skills/arandu-feature of arandu-io/arandu.

Open the folder on GitHubat commit b8a4273

Compare with similar skills

Arandu Feature 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.

Arandu Feature compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arandu Feature this skillarandu-io/arandu281—~2.5kAutomated safety check: PassMIT
GitHub Actions Patbifrost-proxy/bifrost161—~2kAutomated safety check: PassMIT
Browserwingbrowserwing/browserwing1.4k—~1.8kAutomated safety check: PassMIT
MCP Apps Builderawslabs/cli-agent-orchestrator1.4k—~1.7kAutomated safety check: PassApache-2.0
AI Self ImprovementJocysCom/FocusLogger213—~1.1kAutomated safety check: PassGPL-3.0
Setup Matt Pocock Skillsywwynm/EverythingDone1448 repos~1.7kAutomated safety check: PassGPL-3.0

Similar skills

  • GitHub Actions Pat

    bifrost-proxy/bifrost

    用 Personal Access Token 通过 GitHub REST API 分析 Actions CI 的失败 run/job/step、拉取日志、轮询运行状态、做 PR code review，并驱动 fix → push → watch → iterate 的闭环。Token 只从 GITHUBTOKEN 环境变量读取，不落盘、不回显。适合在 bifrost remote /…

    161 GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Browserwing

    browserwing/browserwing

    Browser automation platform with 78 built-in scripts and full CLI.

    1.4k GitHub stars~1.8k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed

  • MCP Apps Builder

    awslabs/cli-agent-orchestrator

    Official

    Load the official MCP Apps builder skills (create-mcp-app, migrate-oai-app, add-app-to-server, convert-web-app) from github.com/modelcontextprotocol/ext-apps.

    1.4k GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • AI Self Improvement

    JocysCom/FocusLogger

    Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills).

    213 GitHub stars~1.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed

  • Setup Matt Pocock Skills

    ywwynm/EverythingDone

    Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…

    144 GitHub starsUsed in 8 repos~1.7k tokens
    Agent WorkflowsAuto-check passed

  • AI Ready

    johnpapa/ai-ready

    ANALYSIS SKILL — Analyze any repository and generate AI-ready configuration — a canonical AGENTS.md, thin per-tool pointer files, skills, CI workflows, issue templates.

    226 GitHub stars~5.4k tokensUpdated 13 days ago
    Agent WorkflowsAuto-check passed

More from arandu-io/arandu

All 12 skills in this repo

  • Arandu API

    arandu-io/arandu

    Answering a program rather than a person in an Arandu (Go) application -- a JSON Resource, a JSON answer from the same routes the pages use, problem+json errors, bearer-token authentication and…

    281 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

  • Arandu Async

    arandu-io/arandu

    Work that does not happen inside the request in an Arandu (Go) application -- background jobs and the worker, scheduled tasks, domain events through the outbox, listeners, notifications, mail and…

    281 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

  • Arandu Shared Modules Guide

    arandu-io/arandu

    Decides whether a feature belongs in the application or in one of five shared Arandu modules before adding permissions, wallets, tags, Markdown rendering or API docs.

    281 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

  • Arandu HTTP

    arandu-io/arandu

    Controllers, requests and routes of an Arandu (Go) application -- the seven resource actions, a resource nested under another, a singleton, a single-action (invokable) controller, a named action…

    281 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

  • Arandu Integrations

    arandu-io/arandu

    Reaching other systems from an Arandu (Go) application, and letting them reach it -- the client of an external API with its interface and fake, webhooks sent and received, and tools, resources and…

    281 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

  • Arandu Module Generator

    arandu-io/arandu

    Adds a new entity, resource or CRUD module to an Arandu Go application by writing a YAML specification instead of hand-writing the Go code.

    281 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Arandu Feature

What does Arandu Feature do?

Start here for any change to an Arandu (Go) application that adds or changes behaviour -- "add invoices", "let users publish a post", "send a weekly report", "call the payment provider", "expose…. Arandu Feature is an agent skill from arandu-io/arandu. Start here for any change to an Arandu (Go) application that adds or changes behaviour -- "add invoices", "let users publish a post", "send a weekly report", "call the payment provider", "expose this to an assistant", "add an API endpoint".

When should I use Arandu Feature?

Arandu Feature fits situations like: tasks that involve REST APIs; tasks that involve Forms and invoices; tasks that involve Agent instruction files.

How do I install Arandu Feature in Claude Code?

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

How do I install Arandu Feature in Codex?

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

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

What does Arandu Feature need to run?

Going by SKILL.md and its folder, Arandu Feature needs the command-line tools its instructions call (go and bash).

Does Arandu Feature 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 Arandu Feature 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 Arandu Feature use?

Arandu Feature is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Arandu Feature use?

About 2.5k tokens (SKILL.md is roughly 9.9k 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 Arandu Feature?

Skills that share tags, products or a category with Arandu Feature: GitHub Actions Pat (bifrost-proxy/bifrost, 161 stars), Browserwing (browserwing/browserwing, 1.4k stars), MCP Apps Builder (awslabs/cli-agent-orchestrator, 1.4k stars) and AI Self Improvement (JocysCom/FocusLogger, 213 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arandu Feature?

arandu-io (a GitHub organization) maintains it in arandu-io/arandu, which has 281 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 10, 2026.

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