mrkeyoor.com_
Sat 03 Oct 06:50 UTC
Dev Toolsevaluationupdated 03 Oct 2026

viserys-agent review

Viserys is an Indonesian-language engineering workflow pack for AI coding agents, and its main user and installation guides are in Indonesian rather than English. Some eval documentation is written in English, but there is no equivalent full English setup guide. The repository supplies skills, commands, reviewer personas, checklists, and adapter files for taking software work from requirements through release.

Verdict

Our Viserys run passed 1 test in 6 seconds, but that test came from a single eval fixture and says little about the 29-skill pack as a whole. Indonesian-speaking Claude Code teams get the most complete path and should trial one workflow before installing everything. Codex, Gemini, Antigravity, and OpenCode users need to accept documented adapter gaps or do their own runtime verification.

We ran it

Lab card: what happened when we ran viserys-agentScreenshot of viserys-agent (github.com/rizqinrr/viserys-agent)
Install✓ · 8s0 packages · 1 MB
Buildn/ano build script
Tests✓ · 6s1 passed · 0 failed of 1 (node:test)
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo222 files~3,921 lines of source · 1 MB · 1 CI workflows · tests dir

Answers from our run

Does viserys-agent build from source?

Dependencies installed in 8 seconds (0 packages), and the project has no separate build step. We cloned commit 5ce22dc into a clean Debian container with 3 CPUs and no project-specific setup.

Do viserys-agent's tests pass?

Yes: 1 of 1 passed when we ran the project's own test command (node:test). Some failures need services or credentials a bare container does not have.

Does viserys-agent have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use viserys-agent?

English-only teams expecting complete user documentation: the README, setup matrix, and command guide are primarily Indonesian.

What are the alternatives to viserys-agent?

Superpowers, Anthropic Skills, Awesome Copilot. Our Viserys run passed 1 test in 6 seconds, but that test came from a single eval fixture and says little about the 29-skill pack as a whole.

Setup3/5Core files are simple, but every host has different wiring
Docs4/5Detailed Indonesian guides with an unusually candid support matrix
Community2/5556 stars, one open pull request, and a very short history
Maturity2/5Version 0.1.0 with several adapters still lacking runtime E2E proof

Who it’s for

Indonesian-speaking teams that want one engineering method across several coding-agent tools.
Claude Code users who can install a local plugin and want commands plus specialist personas.
Maintainers who value explicit approval, review, security, testing, and rollback gates.
Skill authors interested in deterministic trigger and routing checks beside behavioral evals.

Who it’s NOT for

English-only teams expecting complete user documentation: the README, setup matrix, and command guide are primarily Indonesian.
Codex users expecting Viserys commands or persona orchestration: the support matrix lists Codex as skills-only.
Gemini CLI or Antigravity teams requiring runtime-proven adapters: those commands are structurally tested, while runtime end-to-end verification is still absent.
OpenCode users expecting all 7 specialist personas to appear automatically: the root personas are not registered by the project adapter.
Buyers treating our green test as proof of the whole pack: the measured npm project was one eval fixture, not the repository root.
Teams unwilling to audit agent instructions before use: /build auto can execute an approved plan, and /ship can fan work out to several personas.

Setup reality

Our sandbox entered evals/fixtures/ci-cd-and-automation/ at commit 5ce22dc. Npm finished in 8 seconds with 0 packages installed and 1 MB on disk. There was no build target, so build was skipped; node:test passed 1 of 1 tests in 6 seconds.

The core pack is Markdown plus Node validators, without an application server or network service. Actual setup depends on the host: Claude Code uses a local plugin install, Gemini and Antigravity need command files wired into their scopes, and OMP or Codex need skills copied or linked.

The green test belongs to a small CI/CD eval fixture, not all 29 skills or 13 adapters. Full validation requires the repository's structural scripts, routing evals, and, when behavior matters, token-spending agent evals with the relevant harness installed.

29 skills cover a six-stage engineering loop

Viserys organizes agent work as DEFINE, PLAN, BUILD, VERIFY, REVIEW, and SHIP. Its 29 skills cover requirements interviews, specifications, schema design, incremental implementation, debugging, testing, security, performance, documentation, and release work. Seven persona prompts provide narrower viewpoints such as planner, reviewer, security analyst, tester, UI reviewer, performance specialist, and documentation reviewer. The files are instructions and validators rather than an agent runtime.

The command layer turns recurring workflows into 13 entry points. /spec, /plan, /build, /test, /review, and /ship form the main route, while commands for PRDs, schemas, task files, design, constraints, simplification, and web performance cover narrower jobs. The contracts include useful boundaries: planning is read-only before approval, review does not edit by default, and shipping must return a GO or NO-GO decision with a rollback plan.

Claude Code gets the fullest adapter

The Claude Code path has a plugin manifest, two command directories, 7 personas, and an optional SessionStart hook. Installation from a checkout uses Claude's plugin validation, marketplace-add, and user-scope install commands. The repository's one CI workflow exercises that installation flow. Bash and jq are needed only for the optional hook, so the core skills and commands can still load without automatic context injection.

Other hosts receive thinner mappings. OpenCode has a primary viserys agent and one project command, but its root personas do not become subagents automatically. Gemini CLI and Antigravity each get 13 command adapters whose filenames and descriptions are checked for parity. Their runtime installation and persona dispatch have not been verified end to end. OMP uses copied or linked folders, while Codex exposes the skills directory through a plugin manifest.

What happened when we ran it

Our lab found the runnable npm project under evals/fixtures/ci-cd-and-automation/, not at the repository root. At commit 5ce22dc, npm completed in 8 seconds, installed 0 packages, and left 1 MB on disk. The whole checkout contained 222 files, about 3,921 lines of source, and occupied 1 MB. It had 1 CI workflow, no Dockerfile, and a tests directory.

There was no build script or target, so the build step was skipped. Node's test runner completed in 6 seconds with 1 test passed and 0 failed. Npm audit reported 0 known vulnerabilities across all listed severity levels. These results describe the small fixture selected by the harness. They do not establish that every skill routes correctly, that a plugin installs in each host, or that the personas improve a real coding task.

Structural checks stop at consistency

Viserys has scripts for skill frontmatter, command parity, persona references, artifact paths, links, and version consistency. A deterministic routing tier ranks skill descriptions against positive and negative prompts using a lexical method. The eval documentation calls that method an approximation and reserves behavioral evaluation for headless agent runs that create artifacts in throwaway repositories and spend model tokens. That distinction is unusually clear.

The limitation matters because a tidy skill file can still produce poor work. Structural validation can catch a missing command, broken path, or colliding description. It cannot prove that /review spots a security bug or that /build follows a specification under pressure. The behavioral tier is designed for those questions, but it needs the external agent harness, permissions, timeouts, and a grader. Users should run the cases for the skills they plan to trust.

Codex support ends at the skills manifest

The .codex-plugin/plugin.json file registers the shared skills/ directory and identifies version 0.1.0. The installation guide says there is no native Viserys command catalog, primary-agent adapter, verified persona orchestration, or repository-specific installer for Codex. A Codex user can distribute the skills through the host's plugin mechanism, but should not expect /ship to summon the documented reviewer fan-out automatically.

That gap changes the product. Viserys's strongest ideas involve handoffs, independent review perspectives, approval points, and a final merge of reports. Loading individual skills preserves the written workflow, while losing some orchestration around it. Teams using a thinner adapter should start with one direct skill invocation, inspect the resulting file changes, and verify which approval and delegation behavior the host actually honors.

September activity shows a new project, not a track record

GitHub showed 556 stars and 1 open pull request on October 3, 2026. The repository was created September 12 and last pushed September 21. There is no tagged GitHub release, while both plugin manifests identify version 0.1.0. The sole open pull request fixes a documentation anchor. Those facts show recent attention and very little history for judging upgrade stability or maintainer response.

Apache-2.0 licensing makes the instruction files easy to inspect and adapt, with upstream attribution retained for the design material. The support matrix is the best reason to take Viserys seriously: it separates available files, structural checks, and runtime proof instead of merging them into one compatibility claim. Use that same standard during adoption. The Claude path deserves the first trial; the other hosts need narrower expectations.

Alternatives

ProjectWhat it isPick it when
Superpowers gh↗An agent skills framework and software-development method with strong workflow discipline.pick this instead when you want a more established skill-driven methodology and its supported integrations fit your agent.
Anthropic Skills gh↗Anthropic's public collection of reusable Agent Skills and examples.pick this instead when you want a skill library and authoring reference without adopting Viserys's full lifecycle.
Awesome Copilot gh↗A community catalog of GitHub Copilot instructions, agents, skills, and configurations.pick this instead when GitHub Copilot is your main host and breadth matters more than one prescribed workflow.

What people are saying

  1. [velocity-scout] rizqinrr/viserys-agent

Sources

  1. Viserys README
  2. Viserys installation and support matrix
  3. Viserys command catalog
  4. Viserys eval documentation
  5. Viserys open pull request 1

More dev tools reviews

ToolReplay · CUDA-for-AMD-Windows · DuoFold-Android · wutw-public · birdview · YOINK · the whole board →