Skip to content
Skills Library
AI & agents · Tool integration

geas-cli

/geas-cli

Provides the Geas runtime write adapter and status interface through the bundled `scripts/geas` CLI. Use when a Skill needs to initialize `.geas/`, read status, record Mission or Task artifacts, record User Judgment, transition state, or preserve payloads after CLI write failure. Do not use to author artifact content or decide whether Evidence is sufficient.

Repository
geas ↗
Licence
Apache-2.0
Last repository change
19.05.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.05.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Provides the Geas runtime write adapter and status interface through the bundled `scripts/geas` CLI. Use when a Skill needs to initialize `.geas/`, read status, record Mission or Task artifacts, record User Judgment, transition state, or preserve payloads after CLI write failure. Do not use to author artifact content or decide whether Evidence is sufficient.

Original author description

Provides the Geas runtime write adapter and status interface through the bundled `scripts/geas` CLI. Use when a Skill needs to initialize `.geas/`, read status, record Mission or Task artifacts, record User Judgment, transition state, or preserve payloads after CLI write failure. Do not use to author artifact content or decide whether Evidence is sufficient.

How it works

  1. Job
  2. Workflow
  3. Inputs
  4. Resources
  5. Gotchas
  6. Stop Conditions
  7. Boundary
Original SKILL.md headings · 93 lines, 751 words
SKILL.md preview
---
name: geas-cli
description: Provides the Geas runtime write adapter and status interface through the bundled `scripts/geas` CLI. Use when a Skill needs to initialize `.geas/`, read status, record Mission or Task artifacts, record User Judgment, transition state, or preserve payloads after CLI write failure. Do not use to author artifact content or decide whether Evidence is sufficient.
---

# Geas CLI

## Job

Run the bundled `scripts/geas` CLI as the single adapter for `.geas/` runtime reads and writes. Resolve `scripts/geas` from the `geas-cli` Skill directory as `<geas-cli Skill directory>/scripts/geas`, not from the caller's current workspace. Keep readable Markdown artifacts, runtime YAML data, CLI guard results, and User Judgment responsibilities separate.

## Workflow

Normal:
- Receive the caller's command purpose and prepared payload path when a write is needed.
- Run `scripts/geas status` before state-sensitive writes when current runtime state is unknown.
- Use readable `.md` artifact payloads for Mission Spec, Mission Design, Task Contract, Evidence, User Judgment, and Mission Evidence records.
- Let the CLI update runtime `.yaml` data such as Run State, Task State, Debt Ledger, and Memory through guarded commands.
- Run the needed `scripts/geas ...` command.
- Treat a successful `--from <path>` write as consuming the prepared payload file; keep the CLI output paths as the durable refs.
- Return the JSON result, written paths, state changes, and any current location fields to the caller.

Common command surface, with `scripts/geas` resolved relative to the `geas-cli` Skill directory:
- `scripts/geas init`
- `scripts/geas status`
- `scripts/geas mission create`
- `scripts/geas mission spec record --from <path>`
- `scripts/geas mission design record --from <path>`
- `scripts/geas mission transition --to <specifying|building|consolidating> [--task <task-id>]`
- `scripts/geas mission evidence record --from <path>`
- `scripts/geas task contract record --task <task-id> --from <path>`
- `scripts/geas task transition --task <task-id> --to <phase>`
- `scripts/geas task evidence record --task <task-id> --kind <implementation|verification|review|challenger|task> --from <path>`
- `scripts/geas judgment record --target <task-result|mission-result> [--task <task-id>] --from <path>`
- `scripts/geas debt record --from <path>`
- `scripts/geas debt update --id <debt-id> --from <path>`
- `scripts/geas memory record --scope <common|role> [--role <role>] --from <path>`

Handoff:
- Return CLI success output as a record ref and state update summary.
- Return CLI failure output as a stop briefing input, including `error.code`, guard failures, current location, and preserved payload path.

User Decision:
- When the caller asks to record User Judgment, require a User-provided judgment payload path.
- If a User decision is missing, return a stop condition instead of creating judgment text.

Stop:
- Preserve the prepared payload path and CLI JSON output.
- Report unavailable script, invalid payload kind, guard failure, missing runtime, state mismatch, or write failure.

## Inputs

Required:

- caller command purpose
- current workspace path
- prepared payload path for record commands
- target Mission, Task, stage, phase, or scope flags when required by the command

Optional:

- prior `scripts/geas status` JSON
- caller stop briefing draft
- CLI stdout and stderr from a failed attempt

## Resources

| Resource | When to use | Purpose |
| --- | --- | --- |
| `scripts/geas` | every runtime read or write | execute the bundled Geas CLI adapter from the `geas-cli` Skill directory |

Run `<geas-cli Skill directory>/scripts/geas --help` to inspect the current command surface before using a command not listed above. On Windows PowerShell, run `node <geas-cli Skill directory>/scripts/geas --help` if the extensionless script cannot execute directly.

## Gotchas

- CLI success means the runtime write or status read succeeded; it does not mean the artifact content is sufficient.
- CLI failure with guard details is a stop condition input, not permission to edit `.geas/` files by hand.
- Markdown artifacts are readable payloads; runtime YAML files are state data guarded by CLI commands.
- User Judgment payloads must come from User decisions, not agent recommendations.
- Mission Evidence is recorded only after Mission result User Judgment and the required Mission closure inputs exist.
- From a repository or workspace root, invoke the resolved Skill script path. For this repository layout, use `node plugins/geas/skills/geas-cli/scripts/geas ...`; `node scripts/geas ...` targets a workspace-local path.
- Do not copy CLI invocation rules into every other Skill; route runtime writes through this adapter.

## Stop Conditions

- `scripts/geas` is missing or cannot execute.
- Required payload path is missing or unreadable.
- Payload frontmatter kind does not match the command.
- CLI exits non-zero or returns `ok: false`.
- CLI guard failure says runtime state is missing, mismatched, invalid, or not ready.
- Caller asks this adapter to author artifact content or decide acceptance.
- User Judgment is requested but no User decision payload exists.

## Boundary

`geas-cli` runs guarded runtime commands and reports their JSON results. It does not author Mission Spec, Mission Design, Task Contract, Evidence, User Judgment, Debt, or Memory content. It does not bypass guards or directly edit runtime files when the CLI rejects a write.
Files in this package (2)
  • SKILL.md 5 KB
  • scripts/geas 534 KB

Versions

The database has no other skills named geas-cli.

Database snapshot: 13.11.2026 · package version 56ab9ef2c4b5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100mission
    Coordinates Geas Mission work as the user entrypoint start a Mission, recover current state, choose specifying/building/consolidating stage handoffs, and prepare User briefings. Use when the user asks to run, continue, inspect, close, or route a Geas Mission. Do not use for…
  • 90building
    Coordinates Geas Task execution loops from accepted Task Contract through role handoffs, Task result User Judgment input, Task Evidence, and next Task or consolidation routing. Use when a Mission is in building stage, Task State needs phase dispatch or recovery, Task result…
  • 95at-email-cli
    Use the AgentTeam Email CLI command `at-email` to operate an agent mailbox. Use when the user wants to check mailbox status, list inbox messages, read safe message content, search mail, mark messages read, archive messages, send email, reply to email, use JSON output for…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.