⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
vowline
Universal operating skill: bind the public task, act from evidence, preserve boundaries, and verify the delivered result.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
Vowline
Universal operating skill: bind the public task, act from evidence, preserve boundaries, and verify the delivered result.
Vowline is a portable SKILL.md package for Codex, Claude Code, Windsurf, Cursor, Gemini CLI, GitHub Copilot, and other skill-compatible agent harnesses. It gives agents the compact operating contract in skills/vowline/SKILL.md: bind the target and future client once, convert visible requirements into predicates over the final surface, preserve public labels and source-backed entity boundaries, prefer native structured tools, edit only the smallest live write set, and verify the delivered surface through the same interface a real user or official consumer will use.
Use it for substantive work with a real deliverable, constraints, evidence requirements, cleanup risk, data interpretation, artifact fidelity, repository scope, or completion criteria. Vowline never overrides higher-priority system, tool, safety, project, or explicit user instructions.
Current benchmark snapshot
A deterministic benchmark snapshot for the exact Vowline 0.7.0 skill body (6057fa00a6c074fe2af5f28b0a11062e69e154acf6296d4c65eb8b63f1cd637c) passes 12 / 13 checked tasks (92.3%) at gpt-5.5 with xhigh reasoning effort. The completed public/verifier-backed rows span SkillsBench, IFEval, LiveBench, and Terminal-Bench; nginx-request-logging is the only open task. This is mostly single-run deterministic verifier evidence, not a pass@2 score or repeated-stability claim. No proxy judges, no LLM-as-judge, no mixed-hash rows, and no all-pass claim. See 6057fa00_benchmark_snapshot.md for the exact rows and result artifact paths. The earlier 0.6.0 failure-only comparison remains archived at 8e427bb4_no_skill_comparison.md.
This is not a benchmark-overfit skill. The tested Vowline contract is a general operating discipline: target and future-client binding, final-surface predicates, public-label preservation, declared-source entity boundaries, scoped live writes, native structured tools, faithful consumer proof, and explicit reporting. It forbids encoding unavailable private facts, hidden tests, private fixtures, benchmark quirks, known answers, one-off paths, measurement tricks, hardcoded outputs, or verifier workarounds.
Quick start
The easiest path is to ask the target agent to install Vowline for itself:
Install Vowline for yourself by following https://github.com/chojondocho/vowline/blob/main/INSTALL.md. Verify installation.
For a project-local install, ask from inside the project:
Install Vowline into this project by following https://github.com/chojondocho/vowline/blob/main/INSTALL.md. Use project-local paths. Verify installation.
To update an existing install after a Vowline release or contract change:
Update Vowline for yourself by following https://github.com/chojondocho/vowline/blob/main/UPDATE.md. Verify the update.
You do not need to clone this repository if your agent can read GitHub and write the relevant local files. Vowline is designed to be installed by agents as well as by humans.
What Vowline changes
Vowline does not add a rigid workflow. It changes the agent's default operating standard for work where incomplete evidence, unchecked artifacts, overbroad edits, hidden checker adaptation, malformed proof predicates, or vague completion claims would create failure.
| Area | 0.7.0 operating requirement |
|---|---|
| Public contract | Bind the target, future client, invocation surface, inputs, output surface, allowed writes, exclusions, success threshold, budget, and final-response shape once. |
| Working ledger | Track facts, sources, exceptions, references, unknowns, decisions, and proof predicates while separating declarations from references, examples from defaults, owner surfaces from fragments, and absence from zero. |
| Final-surface predicates | Convert requirements into checks over required and forbidden bytes, names, literals, case, wrappers, starts, endings, order, counts, domains, precision, persistence, and side effects. |
| Public labels | Preserve distinctive public modifiers and nouns when labels become internal or visible names; avoid generic carriers, synonyms, and private relabeling. |
| Source authority | Build entity rows, mappings, joins, aggregations, metrics, and native artifacts from declared sources and consumer-visible contracts instead of weak compatibility or sample-only support. |
| Tooling and proof | Prefer native structured tools and prove the final artifact or state through the same verifier, parser, renderer, workflow, service, or consumer that will use it. |
| Transferability | Optimize for general competence, not unavailable private facts, known answers, one-off paths, measurement tricks, or verifier workarounds. |
In practice, Vowline keeps agents focused on the same shape as the canonical SKILL.md:
Respect higher-priority system, tool, safety, project, and explicit user instructions.
Bind the target, future client, invocation surface, and final surface once.
Inspect enough public structure to understand the task.
Create the first complete runnable artifact early.
Prefer native structured tools over ad hoc manipulation.
Convert requirements into final-surface predicates.
Edit the smallest live write set.
Preserve public labels, entity boundaries, missing values, and reference-only targets.
Verify the final artifact or runtime state through the real consumer.
Report the changed surface and current proof, separating blockers and non-proof.
Why agents need it
Modern agents can already write, browse, edit, run tools, inspect files, call APIs, and produce artifacts. The recurring failure point is not only raw capability; it is loss of discipline at the boundary between task, evidence, edit scope, and proof.
Typical failures include treating partial artifacts as done, pre-seeding names or payloads a future client must create, expanding broad nouns into unrequested members, flattening missing data into zero, creating records from relation-only targets, accepting weak source matches, replacing a requested literal with a syntactic variant, proving an alternate artifact instead of the final surface, mutating history during cleanup, or reporting an old pass as current proof.
Vowline gives agents a portable default for those failure points. It makes the agent bind the target, future client, invocation surface, and final surface; keep facts, sources, exceptions, unknowns, decisions, and proof predicates separate; preserve public labels and declared entity boundaries; prefer native structured tools and real consumers; limit writes to the smallest live surface; and verify the delivered surface before declaring completion.
For the full details, see the canonical SKILL.md.
Supported agents
Vowline keeps the canonical behavior in skills/vowline/SKILL.md and installs host bridge files for tools that read rules, memories, or instruction files.
| Agent / harness | Project install writes |
|---|---|
| Codex / AGENTS-aware tools | `.agents/skills |
// HOW IT'S BUILT
KEY FILES