skills.rest
ruban-s
ruban-sCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

DevOS

Installs and maintains a verification-gated AI coding harness with spec interviews and health checks.

Updated Sep 3, 2026
Search Tags:#verification#setup#bun#doctor#coding agent#ai harness#spec interview
One-click install
npx skills add https://github.com/ruban-s/DevOS --skill devos-ruban-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: DevOS
Source: https://github.com/ruban-s/DevOS/tree/main/skills/DevOS
Command: npx skills add https://github.com/ruban-s/DevOS --skill devos-ruban-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coding agents often claim work is done without proof. DevOS installs a developer harness that turns feature requests into specs of falsifiable claims and blocks completion until verification gates actually run and pass. ## Core Features & Use Cases - Harness Setup: Repo-local installation of the DevOS runtime, workflows, tools, skills, and hooks with additive, never-clobbering writes. - Spec Interview: Scans a repository and guides a current-state to ideal-state interview that seeds an ISA.md spec of falsifiable claims. - Health Checks and Updates: Runs the Doctor tool to diagnose harness problems and the Update workflow after version bumps. - Use Case: After adding a --json flag to a CLI, the harness keeps each claim open until its bash or test probe passes, blocking the agent from declaring victory on a 2/3 count. ## Quick Start Ask the agent to set up the DevOS harness in this repository and then run the spec interview to seed the project ISA.

Frequently Asked Questions about DevOS

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the DevOS harness in a repository?▼

Invoke the setup workflow, which performs a repo-local install of the runtime, workflows, tools, skills, and hooks. All writes are additive and guarded, and tools run dry-run by default until re-run with --apply.

How do I run the project spec interview?▼

Trigger the spec workflow after setup completes. It scans the repository, walks through current-state and ideal-state questions, and seeds an ISA.md file containing falsifiable claims with test strategies.

How do I check DevOS harness health?▼

Run the doctor command, which routes to the Doctor.ts tool to diagnose what is broken in the harness installation. It reports issues without modifying files.

Does DevOS overwrite existing files during installation?▼

No. All writes are existsSync-guarded copy-missing operations, so populated files and foreign directories are never overwritten or removed. Every tool also prints its plan in dry-run mode before any --apply write.

When should I not use the DevOS skill?▼

Do not use it for life or TELOS onboarding, which belongs to the reference snapshot, or for general coding help, where you should just work in the repo directly. It is scoped to harness setup, spec, doctor, and update tasks.

Related Skills

Explore More Software Engineering Skills→
bjornslibbjornslib

setup-harness

Copy the Claude Code harness into a project Git repository.

Community
Advanced
anderson-joyleanderson-joyle
2

Diagnose

Reproduce software bugs and generate ranked falsifiable hypotheses.

Community
Intermediate
f4rkh4df4rkh4d

forge-react-hooks

Detect React hook order violations using AST-based analysis.

Community
Intermediate
mykaarmamykaarma

scaffold-spring-boot-cicd

Generate Jenkinsfile, seed_groovy, Dockerfile templates for Spring Boot services and modules.

Official
Advanced