Agent skill

Aidd Sudolang Syntax

by paralleldrive in paralleldrive/aidd

Quick cheat sheet for SudoLang syntax. An agent skill from paralleldrive/aidd.

MITAuto-check passed

Install Aidd Sudolang Syntax

skills CLI
$ npx skills add paralleldrive/aidd --skill aidd-sudolang-syntax -a claude-code

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

GitHub CLI
$ gh skill install paralleldrive/aidd aidd-sudolang-syntax --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/paralleldrive/aidd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ai/skills/aidd-sudolang-syntax .claude/skills/aidd-sudolang-syntax && 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
aidd-sudolang-syntax
GitHub stars
384
Token cost
~1.1k tokens
SKILL.md length
468 words
Files
2
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Quick cheat sheet for SudoLang syntax. An agent skill from paralleldrive/aidd.

  • Reading SudoLang pseudocode
  • SKILL.md covers Interfaces, Constraints, Semantic Pattern Matching and Function Definitions, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Function definitions

What it does

Aidd Sudolang Syntax is an agent skill from paralleldrive/aidd. Quick cheat sheet for SudoLang syntax. Use when writing or reading SudoLang pseudocode, interfaces, constraints, or function definitions.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

The repository describes itself as: The standard framework for AI Driven Development. The licence is MIT.

When your agent uses it

  • Reading SudoLang pseudocode
  • Function definitions

Example prompts

  • “/aidd-sudolang-syntax”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Aidd Sudolang Syntax loads about 1.1k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 468 words of instructions outside code blocks.

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

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 paralleldrive/aidd at commit 9a7c8e3, republished under its MIT licence (© paralleldrive). 468 words, ~1,126 tokens.

Download SKILL.mdSave it as .claude/skills/aidd-sudolang-syntax/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
aidd-sudolang-syntax
description
Quick cheat sheet for SudoLang syntax. Use when writing or reading SudoLang pseudocode, interfaces, constraints, or function definitions.

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" }

Arrays and Objects

// arrays [1, 2, 3]

// nested arrays [ { foo: "bar" }, [123] ]

Comments

// a comment

/* a block comment / fn bar(/ a block comment in parameter position /) { // a function-nested comment a constraint / function-nested block comments (not recommended due to token consumption, but available if you really need it) */ "return $template" // end of line comment }

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

Operators

Note: Most operators don't usually get special syntax highlighting, but they are still important to include.

// Logical Operators isAdult = age >= 18 canVote = isAdult && isCitizen canDrink = isAdult || hasParentalConsent uniqueFeature = hasFeatureA xor hasFeatureB isUnavailable = !inStock

// Complex logical expression isEligible = (age >= 21) && (hasValidID) && ((hasCreditCard) || (hasCash)) && !(isBlacklisted)

// Math Operators sum = a + b difference = x - y product = length * width quotient = total / count power = base ^ exponent remainder = 17 % 5

// Complex math expression result = ((10 + 5) * 3 - (20 / 4)) ^ 2 % 7

// Set Operators commonFruits = tropicalFruits intersection localFruits allFruits = tropicalFruits union localFruits

// Note: The cup and cap operators are deprecated in favor of union and intersection due to instability in Claude 3.5.

// Combining different operators finalScore = (baseScore + bonusPoints) * difficultyMultiplier isWinner = (finalScore > highScore) && !isDisqualified

// Assignment with operation counter = 0 counter += 1 // Increment total -= discount // Decrement price *= taxRate // Multiply and assign share /= numberOfPeople // Divide and assign

// Function nesting fn foo() { counter = 0 counter += 1 // Increment total -= discount // Decrement price *= taxRate // Multiply and assign share /= numberOfPeople // Divide and assign }

// Comparison Operators isEqual = a == b isNotEqual = x != y isGreater = score > threshold isLessOrEqual = quantity <= maxLimit

// Ternary if/else access = if (age >= 18 && isMember) "granted" else "denied"

// Pipe operator for function composition processedData = rawData |> normalize |> filter |> sort

Disallowed Keywords

Should generate a warning for disallowed keywords.

class Foo extends Bar { constructor() { super() } }

© paralleldrive, 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 ai/skills/aidd-sudolang-syntax of paralleldrive/aidd.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 9a7c8e3

Compare with similar skills

Aidd Sudolang Syntax 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.

Aidd Sudolang Syntax compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aidd Sudolang Syntax this skillparalleldrive/aidd384—~1.1kAutomated safety check: PassMIT
Sheets Artifactasgeirtj/system_prompts_leaks69k—~1.2kAutomated safety check: PassCC0-1.0
Google Sheetscursor/plugins10k—~1.1kAutomated safety check: PassNone
Google Sheets Automationsickn33/agentic-awesome-skills47k1 repos~675Automated safety check: PassApache-2.0
Gws Sheets Appendgoogleworkspace/cli31k1 repos~389Automated safety check: PassApache-2.0
Gws Sheets Readgoogleworkspace/cli31k1 repos~279Automated safety check: PassApache-2.0

Similar skills

  • Sheets Artifact

    asgeirtj/system_prompts_leaks

    A skill your agent uses when creating, editing, or inspecting a spreadsheet or workbook (Excel, Google Sheets, or CSV), or when the task calls for a reusable budget, model, tracker, or structured…

    69k GitHub stars~1.2k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Google Sheets

    cursor/plugins

    Official

    Build and edit Google Sheets with the google-sheets tools - values, formatting, charts, conditional formatting, structure, validation, named and protected ranges.

    10k GitHub stars~1.1k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Google Sheets Automation

    sickn33/agentic-awesome-skills

    Read and edit Google Sheets through an available authenticated connector or reviewed API integration, with scoped changes and read-back verification.

    47k GitHub starsUsed in 1 repo~675 tokens
    Documents & OfficeAuto-check passed
  • Gws Sheets Append

    googleworkspace/cli

    Google Sheets: Append a row to a spreadsheet. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~389 tokens
    Documents & OfficeAuto-check passed
  • Gws Sheets Read

    googleworkspace/cli

    Google Sheets: Read values from a spreadsheet. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~279 tokens
    Documents & OfficeAuto-check passed
  • N8n Expression Syntax

    davila7/claude-code-templates

    Validate n8n expression syntax and fix common errors. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 4 repos~2.4k tokens
    Productivity & AutomationAuto-check passed

More from paralleldrive/aidd

All 35 skills in this repo
  • AIDD Skill Authoring Guide

    paralleldrive/aidd

    Guides creating, reviewing or refactoring AI-Driven Development skills so each one stays minimal, composable and named around a single clear function.

    384 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • AIDD UI Layout Patterns

    paralleldrive/aidd

    Enforces a split of UI components into terminal and layout types, with layout components composing others through standard layout tokens, for cleaner structure and fewer re-renders.

    384 GitHub stars~562 tokensUpdated 3 mo ago
    Auto-check passed
  • Adobe Data ECS Plugin Rules

    paralleldrive/aidd

    Enforces @adobe/data/ecs practices when writing Database.Plugin definitions, including property order, plugin composition, services, components, resources and archetypes.

    384 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Error Causes Handling

    paralleldrive/aidd

    Has your agent throw and catch JavaScript and TypeScript errors with the error-causes library, using named causes, preserved originals and routed handlers.

    384 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Teaches the saga pattern with call and put so network requests and side effects stay out of the logic and sagas can be tested without mocks.

    384 GitHub stars~587 tokensUpdated 3 mo ago
    Auto-check passed
  • Lit Element Authoring

    paralleldrive/aidd

    Rules for writing Lit elements in an AIDD project: binding elements on DatabaseElement, observed values, presentation components and action-style callbacks.

    384 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Aidd Sudolang Syntax

What does Aidd Sudolang Syntax do?

Quick cheat sheet for SudoLang syntax. An agent skill from paralleldrive/aidd. Aidd Sudolang Syntax is an agent skill from paralleldrive/aidd. Quick cheat sheet for SudoLang syntax.

When should I use Aidd Sudolang Syntax?

Aidd Sudolang Syntax fits situations like: reading SudoLang pseudocode; function definitions.

How do I install Aidd Sudolang Syntax in Claude Code?

Run `npx skills add paralleldrive/aidd --skill aidd-sudolang-syntax -a claude-code`. Or copy the skill folder (ai/skills/aidd-sudolang-syntax in paralleldrive/aidd) into .claude/skills/aidd-sudolang-syntax in your project. Claude Code loads it when a task matches its description.

How do I install Aidd Sudolang Syntax in Codex?

Run `npx skills add paralleldrive/aidd --skill aidd-sudolang-syntax -a codex`. Or copy the skill folder (ai/skills/aidd-sudolang-syntax in paralleldrive/aidd) into .agents/skills/aidd-sudolang-syntax in your project. Codex loads it when a task matches its description.

Can I use Aidd Sudolang Syntax 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 paralleldrive/aidd --skill aidd-sudolang-syntax -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aidd-sudolang-syntax, .gemini/skills/aidd-sudolang-syntax, .github/skills/aidd-sudolang-syntax and .opencode/skills/aidd-sudolang-syntax in your project.

What does Aidd Sudolang Syntax need to run?

SKILL.md names no scripts, command-line tools or credentials: Aidd Sudolang Syntax is instructions for the agent only.

Does Aidd Sudolang Syntax 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 Aidd Sudolang Syntax 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 Aidd Sudolang Syntax use?

Aidd Sudolang Syntax 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 Aidd Sudolang Syntax use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Aidd Sudolang Syntax?

Skills that share tags, products or a category with Aidd Sudolang Syntax: Sheets Artifact (asgeirtj/system_prompts_leaks, 69k stars), Google Sheets (cursor/plugins, 10k stars), Google Sheets Automation (sickn33/agentic-awesome-skills, 47k stars) and Gws Sheets Append (googleworkspace/cli, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aidd Sudolang Syntax?

paralleldrive (a GitHub organization) maintains it in paralleldrive/aidd, which has 384 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on June 12, 2026.

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