# Coordinate AI Agent Workflows with JEO

Complex AI coding sessions need consistent planning, verification, and handoff controls. JEO provides a cross-tool workflow for plan review, execution, UI feedback, and cleanup.

## Install

```bash
npx skillstore add supercent-io/jeo
```

## Metadata

- Status: approved
- Slug: supercent-io-jeo
- Version: 1.3.1
- Author version: 1.3.1
- Skillstore revision: r1
- Version status: valid
- Tree hash: 2e395be2feb13845fdb475d53a83aaf2ce3fea1aef9c81bbbd203000579ea501
- Author: supercent-io
- GitHub username: supercent-io
- License: MIT
- Repository: https://github.com/supercent-io/skills-template/tree/main/.agent-skills/jeo/
- Ref: 3e4b6c31a74a3bd1a291c98cf585d720cb9fbc88
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: blocked
- Manual install advisory: allowed\_with\_warning
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem, env\_access
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/supercent-io-jeo
- Manifest: https://skillstore.pages.dev/api/skills/supercent-io-jeo/manifest

## Capabilities

- Tracks workflow phase and approval state in a project state file.
- Configures integrations for Claude Code, Codex, Gemini CLI, and OpenCode.
- Runs plannotator plan review loops and records approval or feedback.
- Supports agentation-based UI annotation review through local MCP or HTTP flows.
- Checks installed tools and reports missing workflow components.
- Provides worktree cleanup helpers after an agent workflow finishes.

## Use Cases

- Structure a coding workflow: Create a plan gate, execution phase, verification step, and cleanup step for a coding task.
- Review browser UI changes: Run browser verification and collect submitted UI annotations before resolving feedback.
- Standardize agent setup: Install similar orchestration behavior across several AI coding tools.

## Prompt Templates

### Plan a small task

```
Use JEO to plan this task first, then wait for plan approval before implementation: <task>.
```

### Verify a UI change

```
Use JEO to implement this UI change, verify the page in a browser, and summarize the visible result.
```

### Process UI annotations

```
Use JEO annotate mode after I submit UI annotations. Acknowledge each item, apply fixes, and report what changed.
```

### Audit the workflow setup

```
Review the JEO setup for this repository. Identify which hooks, prompts, local services, and cleanup steps are active.
```

## Limitations

- Requires git, Node 18 or later, bash, Python, and optional external CLIs.
- Setup scripts can change user-level AI tool configuration files.
- Browser and annotation flows require a running app and reachable localhost services.
- Plan gates can fail in sandboxes that block local port binding.

## Best Practices

- Run setup scripts with dry-run first and review every configuration change.
- Use JEO only in trusted repositories where local hooks are expected.
- Keep localhost services private and stop them when the workflow ends.

## Anti Patterns

- Do not run the full installer in an untrusted repository.
- Do not let the skill auto-modify application entry points without reviewing the diff.
- Do not treat generated plan approval as a replacement for human review on sensitive work.

## Security Audit

- Audited at: 2026-07-09T09:05:35.058\+00:00
- Summary: The audit confirms serious install and persistence risks, including a remote installer executed through bash, user-level AI tool hooks, and automatic project source modification. Many markdown, localhost, and status-check matches were false positives, but the remaining confirmed behavior is enough to require manual review before publishing. No direct credential exfiltration intent was found. Static review was capped at 400/850 representative findings; omitted static matches are unconfirmed, so automatic publishing stays disabled until manual review.

## Stats

- Views: 130
- Downloads: 12
- Favorites: 0
- Popularity score: 0