aidd-sudolang-syntax

aidd-sudolang-syntax is a skill for Claude Code, Codex from paralleldrive/aidd. It costs 36 tokens per session (1,113 once invoked), scanned A, original, MIT.

A quick reference for SudoLang, a pseudocode language for describing interfaces, rules, constraints, and functions. It explains the notation used to express structured instructions without writing a complete program.

In plain words
What is it for?
Creating or interpreting SudoLang interfaces, constraints, semantic pattern rules, and function definitions. It is useful when documenting agent behaviour or expressing logic in SudoLang.
Why use it?
It helps developers and agents read or write SudoLang consistently instead of guessing its syntax. The examples show how to represent data shapes, conditions, and repeated actions.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/paralleldrive/aidd/aidd-sudolang-syntax
Any agent
npx skills add paralleldrive/aidd --skill aidd-sudolang-syntax
Clone the repo
git clone --depth 1 https://github.com/paralleldrive/aidd

Made for: Claude Code, Codex.

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 aidd-sudolang-syntax

README.md
[![agentmods](https://agentmods.dev/badge/skills/paralleldrive/aidd/aidd-sudolang-syntax.svg)](https://agentmods.dev/skills/paralleldrive/aidd/aidd-sudolang-syntax)
Your own site
<a href="https://agentmods.dev/skills/paralleldrive/aidd/aidd-sudolang-syntax"><img src="https://agentmods.dev/badge/skills/paralleldrive/aidd/aidd-sudolang-syntax.svg" alt="Measured on agentmods" height="20"></a>
Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,113 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00036 $0.01113
Opus 5 $0.00018 $0.00557
Sonnet 5 $0.00007 $0.00223
Haiku 4.5 $0.00004 $0.00111

Measured 6d ago against content hash 0a65af8e77e8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

aidd-sudolang-syntax 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 6d ago.

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.

ai/skills/aidd-sudolang-syntax/SKILL.md · 224 lines

How it starts

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

SudoLang Syntax

A quick cheat sheet for SudoLang syntax.

Interfaces

DisplayTheme { mode: "light" | "dark" name: String parameters{} // each theme can have different sets of parameters permissions[] }

UserPreferences { displayTheme }

User { id: String displayName preferences }

Constraints

constraint: can be specified inline or in block form

Constraints { A constraint Another constraint }

Semantic Pattern Matching

Map conditions to results by meaning:

(pattern) => result

e.g.

(logic is deterministic) => CLI tool, compiled Bun bundle
(logic requires judgment) => AI prompt

Patterns mix naturally into Constraints blocks:

// Real SudoLang agent skill constraints:
Constraints {
  Prefer natural language in markdown format
  (logic is deterministic) => CLI tool, compiled Bun bundle
  (logic requires judgment) => AI prompt
}

Function Definitions

// You can define an inferred function with the fn or function keywords: fn foo(); function bar();

// You can also define them with function bodies: fn foo() { Constraints { a constraint }

for each (foo) bar() while (!done) work() }

// Functions with blocks can omit the fn or function keyword: anotherFunction() { require user to be signed in }

Function Modifiers

function simple():modifier = value

function complex():nestedModifier={key: "value"}

// You can shape function behavior at call time. doSomethingMultiLine():{ // we can freely mix variable assignments and constraints: format = numbered markdown list lineLength = concise this is a constraint this is another constraint }

Object Literals

updateUser({ id: "123", name: "Pup" })

Template Strings

"foo $bar" foo $bar

Note: Avoid single quotes for strings, because they are used as apostrophes in natural language, and they can break the syntax hightlighting badly.

// nested template strings: ["foo $bar"]

// nested template strings with objects: { name: "Hello, $name" }

Read the full file on GitHub · 224 lines

Files

What ships with it

1 file 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. 6d ago First seen · 224 lines · 36 tokens per session scan A 0a65af8e77e8

Subscribe to this mod's changes

aidd-sudolang-syntax is a skill published in the GitHub repository paralleldrive/aidd (380 stars, last pushed 2mo ago), licensed MIT. It adds 36 tokens to every session and 1,113 once invoked, about $0.0002 per session on Opus 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-08-30.

Related

Other skills, from other repositories

adk-unit-design

Writes an as-built architecture document for one ADK code unit — purpose, execution flow, data flow, cross-class dependencies, extension points, and the parts that must not change — to docs/design/{topic}/{unit}/index.md. It describes the code as implemented, not a proposed design, and its reader is a developer about…

google/adk-python · 181 tokens

artifact-deploy

One-click deploy a user's pre-built app/artifact into their OWN AWS account and get a global public HTTPS link (Vercel-like), with a default TTL and promote-to-persistent. Use when the user says "deploy this", "ship this demo", "give me a public link", "share this externally", or "deploy to AWS".

kirodotdev/KiroCrew · 74 tokens

explain-for

Explain a topic, a piece of code, an error, or a design decision calibrated to one named audience — a 5-year-old, a 5th grader, a manager, a designer, a graduate student, a parent. Resolves who the explanation is for (from the request, or from what memory already records about that person), establishes the ground…

kirodotdev/KiroCrew · 102 tokens

web-verify

Look at your OWN front-end change before claiming it works -- navigate the loopback URL of a dev server or pod you started, screenshot the surface you changed, read the image to judge it, and embed it in chat. Three capture backends: playwright-cli (the session the dashboard Browser panel shows), the agent-browser CLI…

kirodotdev/KiroCrew · 0 tokens

widgets

Render rich HTML inline via tags with theme-aware styling. Load when emitting an mcwidget so the iframe inherits the dashboard theme instead of clashing with light / dark / custom palettes.

kirodotdev/KiroCrew · 42 tokens

learn-from-sage

Detection-gap (miss) analysis for Code Review Sage. Learn from shipped fixes, acted-on human comments, and design outcomes to close reviewer blind spots. Inline during review stages a candidate; a human triggers a one-shot AI consolidation into the live ruleset.

kirodotdev/KiroCrew · 56 tokens