Back to Skills

terminal-ops

Evidence-first repo execution workflow for ECC. Use when the user wants a command run, a repo checked, a CI failure debugged, or a narrow fix pushed with exact proof of what was executed and verified.

189,255stars29,267forksUpdated 5/24/2026

Security Assessment

Safe(100/100)
Security Score100/100

About terminal-ops

The terminal-ops skill provides a focused, evidence-first workflow for executing and verifying operations directly in a repository. It is designed to handle tasks that involve running commands, inspecting git states, debugging CI failures, and applying narrow fixes with precise proof of execution and verification. Unlike general coding guidance tools, this skill emphasizes controlled and auditable operations, ensuring that all actions are traceable and confirmed before claims of success or deployment are made.

Its main features include a structured workflow for resolving the working surface, carefully reading failing surfaces before intervention, keeping fixes narrow and targeted, and reporting the exact execution state. The skill leverages complementary ECC-native skills such as verification-loop, tdd-workflow, security-review, github-ops, and knowledge-ops, which support regression testing, security considerations, CI interactions, and knowledge capture. Output is standardized to show the surface, evidence, actions taken, and precise status (inspected, changed locally, verified locally, committed, pushed, or blocked), making it ideal for reproducible and verifiable development tasks.

Terminal-ops is primarily aimed at developers and operators who require precise, evidence-backed control over repository actions. It is useful for scenarios where a user needs to debug a build, apply a minimal fix, or verify that a change has been correctly applied and pushed. It is also beneficial for code reviewers and team members who need to audit operations without risk of unintended changes. By enforcing narrow, verifiable workflows, terminal-ops reduces the risk of accidental repository-wide modifications and ensures that every action is accountable and reproducible.

FAQ

When should I use the terminal-ops skill?

Use terminal-ops when you need to run commands, inspect git state, debug CI or builds, make a narrow fix, or provide exact proof of what was executed and verified.

Does terminal-ops integrate with CI or GitHub workflows?

Yes, it can leverage github-ops for tasks that depend on CI runs, PR state, or release status, ensuring operations are coordinated with repository management tools.

What are the limitations of terminal-ops?

It is intentionally narrow, focusing on local, verifiable changes and avoiding destructive git commands or repo-wide modifications. It does not provide broad coding guidance.

What output format does terminal-ops use?

The skill outputs a structured format including SURFACE (repo, branch, requested mode), EVIDENCE (failing command/diff/test), ACTION (what changed), and STATUS (inspected, changed locally, verified locally, committed, pushed, blocked).

Who is the target user for this skill?

Developers, operators, and code reviewers who need precise, evidence-backed control over repository operations with clear verification and audit trails.

Install terminal-ops

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill