Agent skill

Neru Add Platform Feature

by y3owk1n in y3owk1n/neru

Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs…

MITAuto-check passedTesting & QA

Install Neru Add Platform Feature

skills CLI
$ npx skills add y3owk1n/neru --skill neru-add-platform-feature -a claude-code

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

GitHub CLI
$ gh skill install y3owk1n/neru neru-add-platform-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/y3owk1n/neru.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/neru-add-platform-feature .claude/skills/neru-add-platform-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
neru-add-platform-feature
GitHub stars
805
Token cost
~713 tokens
SKILL.md length
311 words
Files
2
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs…

  • Works in 3 steps: Read internal/adapter/platform/AGENTS.md… → Read… → Read the port you're implementing in…
  • Any change under internal/adapter/platform
  • SKILL.md covers Before writing code, Tests, Docs (same change, not a… and Verify
  • Calls just and go

What it does

Neru Add Platform Feature is an agent skill from y3owk1n/neru. Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs ownership table. Use for any change under internal/adapter/platform or any darwin/linux/windows file. Not for pure-Go domain logic.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Testing & QA, covering Integration testing. It works with Linux and macOS. The repository describes itself as: Hints, grids and vim keys for your whole desktop. Built for macOS, linux and windows, natively. The licence is MIT.

When your agent uses it

  • Any change under internal/adapter/platform
  • Any darwin/linux/windows file

Example prompts

  • “/neru-add-platform-feature”

Workflow steps

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

  1. Read internal/adapter/platform/AGENTS.md — the single home for the rules
  2. Read internal/adapter/platform/profile.go. It is the source of truth for
  3. Read the port you're implementing in internal/ports/. If the capability

What it can do on your machine

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

    • just
    • go

    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

Neru Add Platform Feature loads about 713 tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 311 words of instructions outside code blocks.

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

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 y3owk1n/neru at commit 8efb605, republished under its MIT licence (© y3owk1n). 311 words, ~713 tokens.

Download SKILL.mdSave it as .claude/skills/neru-add-platform-feature/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
neru-add-platform-feature
description
Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs ownership table. Use for any change under internal/adapter/platform or any *_darwin/_linux/_windows file. Not for pure-Go domain logic.

Platform work in Neru

Platform code carries Neru's strictest guardrails, and this is where agents most often guess. A change that lands cleanly sits in an existing file slot, crosses the boundary through a port, returns CodeNotSupported wherever it is unimplemented, and reports itself honestly in the capability matrix.

Before writing code

  1. Read internal/adapter/platform/AGENTS.md — the single home for the rules this skill obeys: the One Rule, file slots, the factory and Linux's runtime compositor axis, loud stubs, capability honesty, coordinates, generated Wayland bindings. Add the darwin/ or linux/ guide for the native boundary you touch.
  2. Read internal/adapter/platform/profile.go. It is the source of truth for each subsystem's backend family, primary-modifier expectations, and whether a backend needs CGO. CGO is a per-backend decision, not a per-OS one.
  3. Read the port you're implementing in internal/ports/. If the capability doesn't have a port yet, define the interface there first and add a mock in internal/ports/mocks.

Tests

  • Unit tests with port mocks stay platform-neutral.
  • Real-OS behavior goes in *_integration_<os>_test.go tagged //go:build integration && <os>.
  • Contract tests pin CodeNotSupported per subsystem, not per stub. Update the subsystem's existing one if it has one, and write a new one when a caller could read the stub's nil as success, so a later "implementation" that silently no-ops fails a test. internal/adapter/platform/AGENTS.md names the ones that exist.

Docs (same change, not a follow-up)

docs/contributing/porting.md has the ownership table ("Documentation Checklist") — each fact has exactly one home. Capability status goes in docs/reference/platform-support.md, the API or protocol behind it in docs/contributing/platform-internals.md, and never either in docs/contributing/architecture.md (shape only). Linux setup specifics go in docs/guide/linux.md / docs/guide/linux-desktops.md.

Verify

bash
just lint                      # depguard enforces the One Rule
go test ./internal/architecture/
just test-foundation

Cross-compile the platforms you touched (just build-linux, just build-windows) even when you can't run them — build tags hide breakage from a darwin-only just build. Then the standard pre-commit gate, and ask a maintainer to run integration tests on the target OS if you can't.

© y3owk1n, MIT. 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 1 other file in .agents/skills/neru-add-platform-feature of y3owk1n/neru.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 8efb605

Compare with similar skills

Neru Add Platform 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.

Neru Add Platform Feature compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Neru Add Platform Feature this skilly3owk1n/neru805—~713Automated safety check: PassMIT
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
Cross Platform Pathsmicrosoft/vscode-python-environments141—~1.5kAutomated safety check: PassMIT
Testingstatic-web-server/static-web-server2.4k—~2.1kAutomated safety check: PassApache-2.0
Cross Platform Gui E2E TestStudentWeis/ropy193—~1.9kAutomated safety check: PassMIT
Build Northstarnordstjernen-web/northstar-browser128—~1.3kAutomated safety check: PassGPL-3.0

Similar skills

  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • Cross Platform Paths

    microsoft/vscode-python-environments

    Official

    Critical patterns for cross-platform path handling in this VS Code extension.

    141 GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Testing

    static-web-server/static-web-server

    Write or review tests for the Static Web Server (SWS) project — unit tests, handler and static-file integration tests, TOML and file fixtures, property tests, fuzz targets, and benchmarks.

    2.4k GitHub stars~2.1k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Run packaged Ropy desktop GUI end-to-end, smoke, and compatibility tests across macOS, Windows, and Linux.

    193 GitHub stars~1.9k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Build Northstar

    nordstjernen-web/northstar-browser

    Configure, compile, and smoke-test a Meson-based C or C++ desktop browser on Linux, macOS, or Windows, and diagnose dependency, compiler, linker, runtime-library, build-directory, or…

    128 GitHub stars~1.3k tokensUpdated today
    Testing & QAAuto-check passed
  • Openclaw Parallels Smoke

    SafeAI-Lab-X/ClawKeeper

    End-to-end Parallels smoke, upgrade, and rerun workflow for OpenClaw across macOS, Windows, and Linux guests.

    1k GitHub stars~1.1k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

More from y3owk1n/neru

  • Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md.

    805 GitHub stars~843 tokensUpdated today
    Auto-check passed
  • Add or change a Neru config.toml option end to end: struct field, shared and platform defaults, validation, examples, docs, and hot-reload behavior.

    805 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Neru Ask

    y3owk1n/neru

    Answer a Neru user's question about what Neru does, which command, flag, or config key does a thing, why something does not work, or what to try next, from the help, man pages, and docs of their…

    805 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Neru Create PR

    y3owk1n/neru

    Commit working changes and open a Neru pull request the maintainer's way: conventional commit subjects, a PR title written for the changelog, the just ci gate, and the repo PR template filled…

    805 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Neru File Issue

    y3owk1n/neru

    File a Neru bug report or feature request that matches the repo's issue forms: duplicate check first, every required field filled with real diagnostics, correct labels.

    805 GitHub stars~890 tokensUpdated today
    Auto-check passed
  • Neru Setup Config

    y3owk1n/neru

    Set up or change a user's Neru config.toml: find or create the file, bind or disable hotkeys, tune hints, grids, or scroll, add per-app overrides, macros, or declared modes, set up the login…

    805 GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Neru Add Platform Feature

What does Neru Add Platform Feature do?

Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs…. Neru Add Platform Feature is an agent skill from y3owk1n/neru. Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs ownership table.

When should I use Neru Add Platform Feature?

Neru Add Platform Feature fits situations like: any change under internal/adapter/platform; any darwin/linux/windows file.

How do I install Neru Add Platform Feature in Claude Code?

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

How do I install Neru Add Platform Feature in Codex?

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

Can I use Neru Add Platform 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 y3owk1n/neru --skill neru-add-platform-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/neru-add-platform-feature, .gemini/skills/neru-add-platform-feature, .github/skills/neru-add-platform-feature and .opencode/skills/neru-add-platform-feature in your project.

What does Neru Add Platform Feature need to run?

Going by SKILL.md and its folder, Neru Add Platform Feature needs the command-line tools its instructions call (just and go).

Does Neru Add Platform 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 Neru Add Platform 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 Neru Add Platform Feature use?

Neru Add Platform Feature 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 Neru Add Platform Feature use?

About 713 tokens (SKILL.md is roughly 2.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 Neru Add Platform Feature?

Skills that share tags, products or a category with Neru Add Platform Feature: Apple Container Test Runner (RustPython/RustPython, 22k stars), Cross Platform Paths (microsoft/vscode-python-environments, 141 stars), Testing (static-web-server/static-web-server, 2.4k stars) and Cross Platform Gui E2E Test (StudentWeis/ropy, 193 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Neru Add Platform Feature?

y3owk1n (a GitHub user) maintains it in y3owk1n/neru, which has 805 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 11, 2026.

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