# Compat Test Skill

> Compat Test Skill

- Skill: `octos-org/compat-test-skill` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add octos-org/compat-test-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/octos-org/compat-test-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: octos-org (https://skillmd.com/u/octos-org)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/octos-org/compat-test-skill

---


# Compat Test Skill

A minimal third-party skill used by the harness compatibility gate. It reads a
text file, emits a short summary, and declares the summary file as a deliverable
artifact via the documented `files_to_send` field.

This skill intentionally avoids any runtime-internal types. It uses only the
stable developer interface fields documented in `docs/app-skill-dev-guide.md`:

- `manifest.json`: `name`, `version`, `author`, `description`, `timeout_secs`,
  `requires_network`, `tools[].name`, `tools[].description`,
  `tools[].input_schema`, `tools[].env`
- `SKILL.md` frontmatter: `name`, `description`, `version`, `author`, `always`,
  `requires_env`
- Binary protocol: `./main <tool_name>` with JSON on stdin, JSON with `output`,
  `success`, `files_to_send` on stdout.

## Tools

### summarize_text

Reads a text file at `input_path`, writes a compact summary to `output_path`,
and returns `output_path` as a deliverable artifact.

**Parameters:**
- `input_path` (required): absolute path of the source text file
- `output_path` (required): absolute path to write the summary to

## Secret Handling

The skill declares `COMPAT_SUMMARY_TOKEN` via `requires_env` and `tools[].env`.
The runtime strips secret-like environment variables from plugin subprocesses
unless allowlisted in `tools[].env`. The skill NEVER writes the secret value
to stdout, stderr, or disk — only the declared env-var *name* appears in the
manifest and SKILL.md.

