arn-spark-arch-vision

arn-spark-arch-vision is a skill for Claude Code from AppsVortex/arness. It costs 125 tokens per session (2,971 once invoked), scanned A, original, MIT.

A conversational workflow for choosing technologies and describing the high-level structure of a new software system. Its main output is an architecture vision document, covering technology choices and how the system is organised.

In plain words
What is it for?
Use it to compare technology options, choose a technology stack, and outline the structure of a greenfield project.
Why use it?
It helps turn a product idea into an agreed technical direction before implementation details are planned. It focuses on the overall approach rather than file layouts, APIs, or code patterns.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: names the AskUserQuestion tool.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the arn-spark plugin — 28 skills, 20 agents shipped together

Good fit Use it to compare technology options, choose a technology stack, and outline the structure of a greenfield project.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add AppsVortex/arness
Claude Code
/plugin install arn-spark

Made for: Claude Code.

Or install arn-spark, the plugin that ships this one along with the rest of its 28 skills, 20 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for arn-spark-arch-vision

README.md
[![agentmods](https://agentmods.dev/badge/skills/appsvortex/arness/arn-spark-arch-vision/github.svg)](https://agentmods.dev/skills/appsvortex/arness/arn-spark-arch-vision)
Your own site
<a href="https://agentmods.dev/skills/appsvortex/arness/arn-spark-arch-vision"><img src="https://agentmods.dev/badge/skills/appsvortex/arness/arn-spark-arch-vision/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for arn-spark-arch-vision

Your own site · 80×15
<a href="https://agentmods.dev/skills/appsvortex/arness/arn-spark-arch-vision"><img src="https://agentmods.dev/badge/skills/appsvortex/arness/arn-spark-arch-vision.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 125 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,971 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00125 $0.02971
Opus 5.5 $0.00050 $0.01188
Sonnet 5.5 $0.00025 $0.00594
Haiku 4.5 $0.00013 $0.00297

Measured today against content hash c282cd1beedf, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

arn-spark-arch-vision scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/arn-spark/skills/arn-spark-arch-vision/SKILL.md · 227 lines

How it starts

The opening of the file, as written. The whole thing — 227 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Arness Arch Vision

Explore technology options and define the system architecture for a greenfield project through iterative conversation, aided by technology research from the arn-spark-tech-evaluator agent. This is a conversational skill that runs in normal conversation (NOT plan mode). The primary artifact is an architecture vision document.

This skill covers the HOW at a high level: what technologies to use and how the system is structured. It does not cover implementation details like file structure, specific APIs, or code patterns -- that is the plan's job (via /arn-code-plan).

Step 0: Ensure Configuration

Read ${CLAUDE_PLUGIN_ROOT}/skills/arn-spark-ensure-config/references/step-0-fast-path.md and follow its instructions. This guarantees a user profile exists and ## Arness is configured with Arness Spark fields before proceeding.

After Step 0 completes, extract from ## Arness:

  • Vision directory, Use cases directory, Prototypes directory, Spikes directory, Visual grounding directory, Reports directory

Prerequisites

A product concept document should exist. Check in order:

  1. Check the configured Vision directory for product-concept.md
  2. If not found, check .arness/vision/product-concept.md at the project root

If a product concept is found: Read it and proceed to Step 1.

If no product concept is found: Inform the user:

"No product concept document found. I recommend running /arn-spark-discover first to define what you are building. Alternatively, you can describe your product briefly and I will work with that."

If the user provides an inline description, proceed with that as the product context. Do not hard-block.

Determine the output directory:

  1. Use the Vision directory path from ## Arness — this is the source of truth
  2. If the output directory does not exist, create it

Workflow

Step 1: Load Product Concept and Extract Requirements

Read the product concept document (or use the inline description). Extract two things:

Read the full file on GitHub · 227 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 227 lines · 125 tokens per session scan A c282cd1beedf

Subscribe to this mod's changes

arn-spark-arch-vision is a skill published in the GitHub repository AppsVortex/arness (33 stars, last pushed today), licensed MIT. It adds 125 tokens to every session and 2,971 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-25.

Related

Other skills, from other repositories

pulumi-automation-api

Load this skill when a user asks how to run Pulumi programmatically, embed Pulumi in an application, orchestrate multiple stacks in code, build a self-service infrastructure portal, replace pulumi CLI shell scripts with code, or use the Pulumi Automation API (LocalWorkspace, createOrSelectStack, inline programs). Also…

pulumi/agent-skills · 90 tokens

adapto-schema-apply

Apply an approved .adapto/schema-plan.json to the CMS — create Article categories and custom collections (with a two-pass step for references), idempotently, via the adapto CLI. Plan-then-apply; writes content. Pairs with adapto:schema-design.

adaptocms/adapto-cms-agent-skills · 64 tokens

agentmail

Email infrastructure for AI agents. Create accounts, send/receive emails, manage webhooks, and inspect billing balance via the AgentMail API.

sickn33/agentic-awesome-skills · 31 tokens

list-connections

Lists Power Platform connections in the current environment. Use when you need a connection ID before adding a connector to a code app.

microsoft/power-platform-skills · 29 tokens

cloudflare-email-routing

Cloudflare Email Routing for receiving/sending emails via Workers. Use for email workers, forwarding, allowlists, or encountering Email Trigger errors, worker call failures, SPF issues.

secondsky/claude-skills · 40 tokens

bun-http-server

Use when building HTTP servers with Bun.serve, handling requests/responses, implementing routing, creating REST APIs, or configuring fetch handlers.

secondsky/claude-skills · 31 tokens