Agent skill

Foundry Spec Properties

by aviggiano in aviggiano/security

Turn whitepapers, protocol specs, and public documentation into Foundry property tests.

MITAuto-check passedDocuments & Office

Install Foundry Spec Properties

skills CLI
$ npx skills add aviggiano/security --skill foundry-spec-properties -a claude-code

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

GitHub CLI
$ gh skill install aviggiano/security foundry-spec-properties --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/aviggiano/security.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/foundry-spec-properties .claude/skills/foundry-spec-properties && 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
foundry-spec-properties
GitHub stars
144
Token cost
~489 tokens
SKILL.md length
209 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Turn whitepapers, protocol specs, and public documentation into Foundry property tests.

  • Codex needs to derive invariants
  • SKILL.md covers Source Handling, Deriving Properties, TDD Policy and Validation
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Conservation rules

What it does

Foundry Spec Properties is an agent skill from aviggiano/security. Turn whitepapers, protocol specs, and public documentation into Foundry property tests. Use when Codex needs to derive invariants, conservation rules, atomicity rules, priority rules, price-view behavior, or accounting properties from external specs without weakening tests that expose production mismatches.

Its SKILL.md is about 490 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 Documents & Office, covering Report writing and Accounting and bookkeeping. The repository describes itself as: Security Reviews and Audit Checklists. The licence is MIT.

When your agent uses it

  • Codex needs to derive invariants
  • Conservation rules
  • Atomicity rules
  • Price-view behavior

Example prompts

  • “/foundry-spec-properties”

What it can do on your machine

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

Foundry Spec Properties loads about 489 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 209 words of instructions outside code blocks.

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

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 aviggiano/security at commit e18ce7d, republished under its MIT licence (© aviggiano). 209 words, ~489 tokens.

Download SKILL.mdSave it as .claude/skills/foundry-spec-properties/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
foundry-spec-properties
description
Turn whitepapers, protocol specs, and public documentation into Foundry property tests. Use when Codex needs to derive invariants, conservation rules, atomicity rules, priority rules, price-view behavior, or accounting properties from external specs without weakening tests that expose production mismatches.

Foundry Spec Properties

Source Handling

Use the current spec source the user names. If it is a URL, fetch or browse it when current access is required. Cite or record the exact source used in the work summary when the property depends on a spec claim.

Separate spec properties from unit/fuzz mirrors. Use a clear directory such as:

text
test/foundry/property/<spec-name>/
test/foundry/properties/

Follow the repository's existing directory convention when one exists.

Deriving Properties

Look for properties that remain true across many inputs:

  • conservation of balances, reserves, shares, or locked amounts
  • quote/preview functions matching execution
  • batch atomicity and required-action rollback
  • price priority, time priority, or path priority
  • price bucket/view consistency
  • add/remove or deposit/withdraw roundtrips
  • permission and lifecycle transitions
  • no accidental balance creation or loss

Prefer public semantics over implementation-specific mechanisms.

TDD Policy

Add the property test first. If it fails, do not fix production or relax the property in the same breath. Report whether the failure appears to be:

  • invalid harness setup
  • reference/spec modeling issue
  • production/spec mismatch
  • ambiguous spec language

Preserve strict equality unless the spec states a tolerance. Rounding-related failures should remain visible unless the user explicitly decides otherwise.

Validation

Run the focused property file with enough verbosity to capture the counterexample. Then run the property subtree or full Foundry suite as appropriate.

© aviggiano, 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 skills/foundry-spec-properties of aviggiano/security.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e18ce7d

Compare with similar skills

Foundry Spec Properties 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.

Foundry Spec Properties compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Foundry Spec Properties this skillaviggiano/security144—~489Automated safety check: PassMIT
Investor Reportrevfactory/harness-1001.3k—~1.7kAutomated safety check: PassApache-2.0
Ar AgingWellApp-ai/Well345—~532Automated safety check: PassMIT
Beancount Reconcilebex-co/beancount-io296—~4.1kAutomated safety check: PassMIT
Receipts To Expensesskrun-dev/skrun210—~1.1kAutomated safety check: PassMIT
Lbo Modelw95/awesome-claude-corporate-skills2441 repos~3kAutomated safety check: PassMIT

Similar skills

  • Investor Report

    revfactory/harness-100

    A full pipeline that systematizes investor reports into financial performance analysis, KPI dashboard, market trends, strategy updates, and risk disclosures.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Beancount Reconcile

    bex-co/beancount-io

    Reconcile one Beancount account against a CSV statement or pasted PDF text.

    296 GitHub stars~4.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Receipts To Expenses

    skrun-dev/skrun

    Read a batch of receipt images directly via vision, classify each into expense categories, optionally reconcile against a bank statement CSV, and produce a multi-sheet Excel workbook + a PDF summary.

    210 GitHub stars~1.1k tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed
  • Lbo Model

    w95/awesome-claude-corporate-skills

    This skill should be used when completing LBO (Leveraged Buyout) model templates in Excel for private equity transactions, deal materials, or investment committee presentations.

    244 GitHub starsUsed in 1 repo~3k tokens
    Documents & OfficeAuto-check passed
  • Fin Daily Pulse

    evolution-foundation/evo-nexus

    Daily financial pulse — queries Stripe (MRR, charges, churn, failures), Omie (accounts payable/receivable, invoices) and Evo Academy (courses, subscriptions, Summit tickets) to generate an HTML…

    545 GitHub stars~1.7k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed

More from aviggiano/security

All 10 skills in this repo
  • Foundry Deploy Fixtures

    aviggiano/security

    Create or refactor Foundry deployment fixtures for Solidity tests.

    144 GitHub stars~634 tokensUpdated 24 days ago
    Auto-check passed
  • Foundry Fuzz Mirrors

    aviggiano/security

    Create Foundry fuzz tests from deterministic unit tests. An agent skill from aviggiano/security.

    144 GitHub stars~584 tokensUpdated 24 days ago
    Auto-check passed
  • Foundry Test Campaign

    aviggiano/security

    Master skill for running an end-to-end multi-pass Foundry testing campaign for Solidity projects.

    144 GitHub stars~1.6k tokensUpdated 24 days ago
    Auto-check passed
  • Stateful Invariant Testing

    aviggiano/security

    Build metric-driven Chimera/create-chimera-app stateful invariant testing campaigns for Solidity projects.

    144 GitHub stars~2.8k tokensUpdated 24 days ago
    Auto-check passed
  • Foundry Differential Tests

    aviggiano/security

    Create Foundry differential tests comparing production Solidity contracts against an independent reference model.

    144 GitHub stars~613 tokensUpdated 24 days ago
    Auto-check passed
  • Foundry Failure Triage

    aviggiano/security

    Classify failing Foundry fuzz, property, invariant, and differential tests.

    144 GitHub stars~637 tokensUpdated 24 days ago
    Auto-check passed

Questions about Foundry Spec Properties

What does Foundry Spec Properties do?

Turn whitepapers, protocol specs, and public documentation into Foundry property tests. Foundry Spec Properties is an agent skill from aviggiano/security. Turn whitepapers, protocol specs, and public documentation into Foundry property tests.

When should I use Foundry Spec Properties?

Foundry Spec Properties fits situations like: Codex needs to derive invariants; conservation rules; atomicity rules; price-view behavior.

How do I install Foundry Spec Properties in Claude Code?

Run `npx skills add aviggiano/security --skill foundry-spec-properties -a claude-code`. Or copy the skill folder (skills/foundry-spec-properties in aviggiano/security) into .claude/skills/foundry-spec-properties in your project. Claude Code loads it when a task matches its description.

How do I install Foundry Spec Properties in Codex?

Run `npx skills add aviggiano/security --skill foundry-spec-properties -a codex`. Or copy the skill folder (skills/foundry-spec-properties in aviggiano/security) into .agents/skills/foundry-spec-properties in your project. Codex loads it when a task matches its description.

Can I use Foundry Spec Properties 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 aviggiano/security --skill foundry-spec-properties -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/foundry-spec-properties, .gemini/skills/foundry-spec-properties, .github/skills/foundry-spec-properties and .opencode/skills/foundry-spec-properties in your project.

What does Foundry Spec Properties need to run?

SKILL.md names no scripts, command-line tools or credentials: Foundry Spec Properties is instructions for the agent only.

Does Foundry Spec Properties 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 Foundry Spec Properties 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 Foundry Spec Properties use?

Foundry Spec Properties 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 Foundry Spec Properties use?

About 489 tokens (SKILL.md is roughly 2k 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 Foundry Spec Properties?

Skills that share tags, products or a category with Foundry Spec Properties: Investor Report (revfactory/harness-100, 1.3k stars), Ar Aging (WellApp-ai/Well, 345 stars), Beancount Reconcile (bex-co/beancount-io, 296 stars) and Receipts To Expenses (skrun-dev/skrun, 210 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Foundry Spec Properties?

aviggiano (a GitHub user) maintains it in aviggiano/security, which has 144 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 15, 2026.

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