How do I install the Compliance Test skill?

Run npx skillmds@latest add tomevault-io/compliance-test in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Compliance Test safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Compliance Test?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Compliance Test free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Compliance Test?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Compliance Test by tomevault-io — Agent Skill

Name: Compliance Test
Author: tomevault-io

File contents

Compliance Test Skill

This skill allows you to verify Octomark's compliance with the CommonMark specification using the official spec tests.

Prerequisites

Python 3
The commonmark-spec submodule must be present in the root directory.
zig must be installed to build the project.

Usage

Using the helper script

The easiest way to run the tests is using the provided helper script:

./scripts/compliance.sh

You can also pass additional arguments to the script (like -P or -n):

./scripts/compliance.sh -P "Links"

Manual Usage

If you prefer to run it manually:

# Build the project first
zig build -Doptimize=ReleaseSafe

# Run the spec tests
python3 commonmark-spec/test/spec_tests.py --program "./zig-out/bin/octomark" --spec commonmark-spec/spec.txt

Run a specific test section

You can limit the tests to a specific section (e.g., "Links") using the -P or --pattern flag:

python3 commonmark-spec/test/spec_tests.py --program "./zig-out/bin/octomark" --spec commonmark-spec/spec.txt --pattern "Links"

Run a single example

Each test in the spec has a number. Use -n to run a specific example:

python3 commonmark-spec/test/spec_tests.py --program "./zig-out/bin/octomark" --spec commonmark-spec/spec.txt -n 123

Interpreting Results

Octomark focuses on extreme performance and streaming efficiency. Some CommonMark edge cases (especially those requiring multiple passes, like complex reference links) might fail. The goal is to maximize compliance without sacrificing the O(N) performance target.

Common failures to ignore or monitor:

Reference Links: Octomark currently focuses on inline links.
HTML Normalization: Minor differences in HTML tag self-closing or whitespace.
Deep Nesting: Octomark has a maximum nesting limit for security.

Mandatory Reporting

For every compliance test run, you MUST report:

Result: Pass/Fail
Failed Tests: List of failed tests
Failed Examples: List of failed examples
Percentage: Percentage of passed examples

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: compliance-testdescription: Run Octomark against the CommonMark spec tests to check for compliance. Use when this capability is needed.---# Compliance Test SkillThis skill allows you to verify Octomark's compliance with the CommonMark specification using the official spec tests.## Prerequisites- Python 3- The `commonmark-spec` submodule must be present in the root directory.- `zig` must be installed to build the project.## Usage### Using the helper scriptThe easiest way to run the tests is using the provided helper script:```bash./scripts/compliance.sh```You can also pass additional arguments to the script (like `-P` or `-n`):```bash./scripts/compliance.sh -P "Links"```### Manual UsageIf you prefer to run it manually:```bash# Build the project firstzig build -Doptimize=ReleaseSafe# Run the spec testspython3 commonmark-spec/test/spec_tests.py --program "./zig-out/bin/octomark" --spec commonmark-spec/spec.txt```### Run a specific test sectionYou can limit the tests to a specific section (e.g., "Links") using the `-P` or `--pattern` flag:```bashpython3 commonmark-spec/test/spec_tests.py --program "./zig-out/bin/octomark" --spec commonmark-spec/spec.txt --pattern "Links"```### Run a single exampleEach test in the spec has a number. Use `-n` to run a specific example:```bashpython3 commonmark-spec/test/spec_tests.py --program "./zig-out/bin/octomark" --spec commonmark-spec/spec.txt -n 123```## Interpreting ResultsOctomark focuses on extreme performance and streaming efficiency. Some CommonMark edge cases (especially those requiring multiple passes, like complex reference links) might fail. The goal is to maximize compliance without sacrificing the O(N) performance target.Common failures to ignore or monitor:- **Reference Links**: Octomark currently focuses on inline links.- **HTML Normalization**: Minor differences in HTML tag self-closing or whitespace.- **Deep Nesting**: Octomark has a maximum nesting limit for security.## Mandatory ReportingFor every compliance test run, you **MUST** report:- **Result**: Pass/Fail- **Failed Tests**: List of failed tests- **Failed Examples**: List of failed examples- **Percentage**: Percentage of passed examples---> Converted and distributed by [TomeVault](https://tomevault.io/claim/tani) — claim your Tome and manage your conversions.

Frequently asked questions

Compliance Test