Agent skill

Invokta Contract Review

by vinilana in vinilana/invokta

Review Invokta contracts for public APIs, acceptance criteria, errors, invariants, operational limits, compatibility, and architectural boundaries.

MITAuto-check passedLegal & Compliance

Install Invokta Contract Review

skills CLI
$ npx skills add vinilana/invokta --skill invokta-contract-review -a claude-code

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

GitHub CLI
$ gh skill install vinilana/invokta invokta-contract-review --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/vinilana/invokta.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/invokta-contract-review .claude/skills/invokta-contract-review && 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
invokta-contract-review
GitHub stars
139
Token cost
~854 tokens
SKILL.md length
370 words
Files
2
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Review Invokta contracts for public APIs, acceptance criteria, errors, invariants, operational limits, compatibility, and architectural boundaries.

  • Works in 5 steps: Read docs/README.md and… → Compare the change with… → Inspect public types, acceptance tests,… → …
  • Tasks that involve Contract review
  • SKILL.md covers Establish the source of truth, Apply the gates and Report the review
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Invokta Contract Review is an agent skill from vinilana/invokta. Review Invokta contracts for public APIs, acceptance criteria, errors, invariants, operational limits, compatibility, and architectural boundaries. Use before implementing or approving changes to interfaces, schemas, ports, events, observable persistence, configuration, or public behavior in this repository.

Its SKILL.md is about 850 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 Legal & Compliance, covering Contract review and User stories. The repository describes itself as: A TypeScript framework for reusable domain AI capabilities across direct, CLI, and MCP transports. The licence is MIT.

When your agent uses it

  • Tasks that involve Contract review
  • Tasks that involve User stories

Example prompts

  • “/invokta-contract-review”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read docs/README.md and docs/vision-and-invariants.md.
  2. Compare the change with docs/architecture.md, docs/scope-and-limits.md, docs/implementation-plan-and-acceptance-criteria.md…
  3. Inspect public types, acceptance tests, and the existing implementation. Do not infer guarantees from examples or internal details.
  4. Identify the consumer, public surface, and change type: additive, compatible, ambiguous, or breaking.
  5. Stay read-only for review requests. Edit only when the user requests fixes.

What it can do on your machine

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

Invokta Contract Review loads about 854 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 370 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
~854

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 vinilana/invokta at commit f1e2f04, republished under its MIT licence (© vinilana). 370 words, ~854 tokens.

Download SKILL.mdSave it as .claude/skills/invokta-contract-review/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
invokta-contract-review
description
Review Invokta contracts for public APIs, acceptance criteria, errors, invariants, operational limits, compatibility, and architectural boundaries. Use before implementing or approving changes to interfaces, schemas, ports, events, observable persistence, configuration, or public behavior in this repository.

Invokta Contract Review

Establish the source of truth

  1. Read docs/README.md and docs/vision-and-invariants.md.
  2. Compare the change with docs/architecture.md, docs/scope-and-limits.md, docs/implementation-plan-and-acceptance-criteria.md, docs/adr/README.md, and applicable ADRs.
  3. Inspect public types, acceptance tests, and the existing implementation. Do not infer guarantees from examples or internal details.
  4. Identify the consumer, public surface, and change type: additive, compatible, ambiguous, or breaking.
  5. Stay read-only for review requests. Edit only when the user requests fixes.

Apply the gates

Gate 1 — Complete surface

Inventory each applicable concern:

  • operations, inputs, outputs, and observable effects;
  • public errors, codes, stable messages, and retry policy;
  • defaults, configuration, ordering, and determinism;
  • timeouts, cancellation, concurrency, and idempotency;
  • size, count, depth, time, and resource limits;
  • versioning, migration, and backward compatibility;
  • responsible ports and ADR-authorized adapters.

Mark missing details as unspecified; do not fill gaps with assumptions.

Gate 2 — Executable acceptance
  • Rewrite vague requirements as binary, observable outcomes.
  • Map requirement → contract → acceptance test → evidence.
  • Require happy paths, expected errors, and inclusive and exclusive boundary cases.
  • Reject criteria based only on internal structure, subjective adjectives, or undefined future implementation.
Gate 3 — Limits and failures
  • Verify validation at the correct boundary and consistent behavior across adapters.
  • Require safe, deterministic failure for invalid input, limit violations, unavailability, and cancellation.
  • Find unbounded resources, duplicate work, uncontrolled growth, and external dependencies without timeouts.
  • Confirm that logs, metrics, and errors expose no secrets or sensitive content.
Show full SKILL.md (143 more words)Show less
Gate 4 — Architecture and evolution
  • Confirm dependency direction and each port and adapter responsibility against the ADRs.
  • Flag framework, transport, or persistence types that leak into the domain.
  • Separate intentional contracts from implementation details. Prevent public tests from freezing internal details.
  • Classify compatibility breaks and require an explicit decision, version, or migration.
Gate 5 — Verdict

Return APPROVED only when contracts, acceptance criteria, and limits are complete, testable, and consistent with the ADRs. Return APPROVED WITH CONDITIONS only for non-blocking risks with concrete actions. Return BLOCKED for material ambiguity, unauthorized breaking changes, missing critical limits, or architectural violations.

Report the review

Present findings first, ordered by severity, with file:line evidence. Then include:

  • a compact traceability matrix;
  • gaps marked as unspecified;
  • compatibility impact;
  • questions requiring decisions;
  • the verdict and pending gates.

Do not report that no issues exist without listing the surfaces and limits checked.

© vinilana, 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 .agents/skills/invokta-contract-review of vinilana/invokta.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit f1e2f04

Compare with similar skills

Invokta Contract Review 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.

Invokta Contract Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Invokta Contract Review this skillvinilana/invokta139—~854Automated safety check: PassMIT
Contract Reviewevolsb/claude-legal-skill4641 repos~3.6kAutomated safety check: PassMIT
Commercial Legal Plapiotrowski-afk/commercial-legal-pl1761 repos~4.1kAutomated safety check: PassApache-2.0
Hand Drawnthreerocks/hand-drawn-styles2.2k—~398Automated safety check: PassMIT
Tabular Document Reviewanthropics/claude-for-legal9.6k3 repos~4.3kAutomated safety check: PassApache-2.0
Tw Formal WritingImbad0202/tw-formal-writing179—~1kAutomated safety check: PassMIT

Similar skills

  • Contract Review

    evolsb/claude-legal-skill

    Review legal contracts, NDAs, employment agreements, SaaS terms, and M&A documents.

    464 GitHub starsUsed in 1 repo~3.6k tokens
    Legal & ComplianceAuto-check passed
  • Commercial Legal Pl

    apiotrowski-afk/commercial-legal-pl

    Skill do analizy i tworzenia umów według polskiego prawa, ze szczególnym uwzględnieniem umów B2B, IP i IT (body leasing, NDA, wdrożenia, SaaS, przeniesienie praw autorskich, ugody).

    176 GitHub starsUsed in 1 repo~4.1k tokens
    Legal & ComplianceAuto-check passed
  • Hand Drawn

    threerocks/hand-drawn-styles

    A skill your agent uses when users ask for a hand-drawn or illustrated image prompt, name one of the repository's 20 numbered styles or the 3.1 stable variant, or mention triggers such as…

    2.2k GitHub stars~398 tokensUpdated 2 days ago
    Legal & ComplianceAuto-check passed
  • Tabular Document Review

    anthropics/claude-for-legal

    Official

    Builds a review grid with one row per document and one column per data point, each cell cited to a verbatim quote, built for M&A diligence and other batch reviews.

    9.6k GitHub starsUsed in 3 repos~4.3k tokens
    Legal & ComplianceAuto-check passed
  • Tw Formal Writing

    Imbad0202/tw-formal-writing

    台灣正式文件撰寫助手 — 涵蓋政府公文、政府機關其他文件、法律文件、人民對政府文書四類中文正式文件的撰寫(不含學術論文、商業文書、私人書信等,見下方排除清單)。

    179 GitHub stars~1k tokensUpdated 16 days ago
    Legal & ComplianceAuto-check passed
  • Contract Review Pro

    CSlawyer1985/contract-review-pro

    专业合同审核 Skill:7步工作流(含立场声明、框架审阅、类型路由)、5类通用门禁+16个专项门禁、终稿三件套+HTML可视化报告、8维度风险评分、修订5分类路由。完全自包含,零外部依赖。

    277 GitHub stars~2.3k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed

More from vinilana/invokta

  • Prepare Invokta Release

    vinilana/invokta

    Prepare Invokta versioned releases on dedicated release branches with synchronized package metadata, changelog and validation evidence, complete repository gates, and one cohesive commit.

    139 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Invokta Delivery

    vinilana/invokta

    Deliver Invokta milestones and work items with TDD, adherence to versioned contracts and architecture, complete validation, and one cohesive commit per work item.

    139 GitHub stars~894 tokensUpdated 5 days ago
    Auto-check passed

Questions about Invokta Contract Review

What does Invokta Contract Review do?

Review Invokta contracts for public APIs, acceptance criteria, errors, invariants, operational limits, compatibility, and architectural boundaries. Invokta Contract Review is an agent skill from vinilana/invokta. Review Invokta contracts for public APIs, acceptance criteria, errors, invariants, operational limits, compatibility, and architectural boundaries.

When should I use Invokta Contract Review?

Invokta Contract Review fits situations like: tasks that involve Contract review; tasks that involve User stories.

How do I install Invokta Contract Review in Claude Code?

Run `npx skills add vinilana/invokta --skill invokta-contract-review -a claude-code`. Or copy the skill folder (.agents/skills/invokta-contract-review in vinilana/invokta) into .claude/skills/invokta-contract-review in your project. Claude Code loads it when a task matches its description.

How do I install Invokta Contract Review in Codex?

Run `npx skills add vinilana/invokta --skill invokta-contract-review -a codex`. Or copy the skill folder (.agents/skills/invokta-contract-review in vinilana/invokta) into .agents/skills/invokta-contract-review in your project. Codex loads it when a task matches its description.

Can I use Invokta Contract Review 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 vinilana/invokta --skill invokta-contract-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/invokta-contract-review, .gemini/skills/invokta-contract-review, .github/skills/invokta-contract-review and .opencode/skills/invokta-contract-review in your project.

What does Invokta Contract Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Invokta Contract Review is instructions for the agent only.

Does Invokta Contract Review 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 Invokta Contract Review 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 Invokta Contract Review use?

Invokta Contract Review 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 Invokta Contract Review use?

About 854 tokens (SKILL.md is roughly 3.4k 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 Invokta Contract Review?

Skills that share tags, products or a category with Invokta Contract Review: Contract Review (evolsb/claude-legal-skill, 464 stars), Commercial Legal Pl (apiotrowski-afk/commercial-legal-pl, 176 stars), Hand Drawn (threerocks/hand-drawn-styles, 2.2k stars) and Tabular Document Review (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Invokta Contract Review?

vinilana (a GitHub user) maintains it in vinilana/invokta, which has 139 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 5, 2026.

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