Htmlvspec
disler/pi-agent-observability
Creates a visual engineering implementation plan as a single self-contained HTML page saved to specs/<name.html — the plan authored directly in styled HTML, with one AI-generated diagram image per…
Execute work through the directive pipeline — evaluate, plan, cast agents, build, review, and report.
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add andrew-yangy/gru-ai --skill directive -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install andrew-yangy/gru-ai directive --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/andrew-yangy/gru-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/directive .claude/skills/directive && rm -rf skills-srcUse ~/.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/
Install the "directive" agent skill from https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directive into .claude/skills/directive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "directive", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directiveType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add andrew-yangy/gru-ai --skill directive -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install andrew-yangy/gru-ai directive --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/andrew-yangy/gru-ai.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/directive .agents/skills/directive && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "directive" agent skill from https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directive into .agents/skills/directive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "directive", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add andrew-yangy/gru-ai --skill directive -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install andrew-yangy/gru-ai directive --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/andrew-yangy/gru-ai.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/directive .cursor/skills/directive && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "directive" agent skill from https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directive into .cursor/skills/directive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "directive", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/andrew-yangy/gru-ai.git --path .claude/skills/directive--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add andrew-yangy/gru-ai --skill directive -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install andrew-yangy/gru-ai directive --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/andrew-yangy/gru-ai.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/directive .gemini/skills/directive && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "directive" agent skill from https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directive into .gemini/skills/directive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "directive", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install andrew-yangy/gru-ai directiveInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add andrew-yangy/gru-ai --skill directive -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/andrew-yangy/gru-ai.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/directive .github/skills/directive && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "directive" agent skill from https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directive into .github/skills/directive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "directive", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add andrew-yangy/gru-ai --skill directive -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install andrew-yangy/gru-ai directive --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/andrew-yangy/gru-ai.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/directive .opencode/skills/directive && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "directive" agent skill from https://github.com/andrew-yangy/gru-ai/tree/main/.claude/skills/directive into .opencode/skills/directive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "directive", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
directiveExecute work through the directive pipeline — evaluate, plan, cast agents, build, review, and report.
Directive is an agent skill from andrew-yangy/gru-ai. Execute work through the directive pipeline — evaluate, plan, cast agents, build, review, and report. Takes a directive name (matching .context/directives/), a project path, or an ad-hoc CEO request. TRIGGER: Use this skill whenever the user requests non-trivial work that goes beyond a one-liner fix. This includes: building features, running projects with project.json, executing multiple tasks, multi-file changes, or any work with defined DOD/reviewers. Route through this pipeline so reviews and verification…
Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 37 other files (for example `docs/pipeline/00-delegation-and-triage.md`, `docs/pipeline/01-checkpoint.md` and `docs/pipeline/02-read-directive.md`).
It sits in Agent Workflows. The repository describes itself as: Autonomous AI agent team for one-man companies. Context engineering + harness engineering drive a pipeline that brainstorms, builds, reviews, and ships. The licence is MIT.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 8fba479. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Directive loads about 2.8k tokens when it runs. Until then it costs about 204 tokens; SKILL.md has 1,092 words of instructions outside code blocks.
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.
The automated check found patterns that need a careful read before installing.
able below and execute it. Do NOT stop, do NOT pause, do NOT ask for confirmation between steps. The pipeline is designeAutomated 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.
The full file from andrew-yangy/gru-ai at commit 8fba479, republished under its MIT licence (© andrew-yangy). 1,092 words, ~2,828 tokens.
.claude/skills/directive/SKILL.md (or your agent's skills folder). This skill also uses 33 other files; get the full folder from GitHub.Execute the CEO directive: $ARGUMENTS
Before executing, read .claude/agent-registry.json to map roles to agent names. The pipeline uses role-based language throughout. Resolve roles to concrete agent names using the registry:
"title": "COO" (plans projects, orchestrates execution)"title": "CTO" (architecture, audits, reviews, technical decomposition)"title": "CPO" (product strategy, UX review, user perspective)"title": "CMO" (growth, SEO, content strategy)"title": "FE" (React, Tailwind, components)"title": "BE" (server, API, infrastructure)"title": "FS" (cross-domain work)"title": "DE" (pipelines, parsers, indexing)"title": "CB" (MDX, documentation, copywriting)"title": "QA" (testing, investigation, validation)"title": "UX" (design review, wireframes, visual quality)Use each agent's id field as the subagent_type value when spawning. Use the agentFile field to locate personality files. The registry is the single source of truth for who fills each role.
YOU MUST read and execute 00-delegation-and-triage.md BEFORE doing anything else.
DO NOT read source code. DO NOT edit files. DO NOT start solving the problem. The pipeline exists to ensure quality — every shortcut you take skips a review, a gate, or a verification step.
Your FIRST action must be: Read the triage doc, classify the directive weight, output the triage block, and create directive.json. Only then proceed to the next pipeline step.
If you catch yourself wanting to "just fix it quickly" — STOP. That impulse is exactly what the pipeline prevents. Even lightweight directives have a defined process (triage → context → audit → plan → build → review → digest → completion). The COO plans for ALL weights.
This file is a routing table. Each row points to a modular doc containing full instructions for that step. Read only the docs you need for the current step — don't load everything at once.
After completing each pipeline step, update .context/directives/{id}/directive.json:
pipeline.{stepId}.status to "completed" with:agent: who performed this step (e.g. "CEO", "COO", "CTO, full-stack engineer")output: REQUIRED object with at least a summary string (1-2 sentences of what happened/decided). Add other keys as relevant (e.g. decision, weight, projects).artifacts: array of file paths produced (if any)current_step to the next step's IDupdated_at to the current ISO timestampWhen starting a step, set pipeline.{stepId}.status to "active" and pipeline.{stepId}.agent to the array of participating agent first names (lowercase, e.g. ["sarah", "marcus", "morgan"]). This is critical for the dashboard game view — the game reads step agents to route characters to the meeting room during brainstorm/plan/clarification steps. Without this, characters won't move.
Why output is mandatory: The dashboard renders pipeline step details directly from directive.json. Without
output.summary, the UI shows empty steps — the CEO can't see what happened. Every step must leave a trace.
The server's directive-watcher reads directive.json directly (NOT current.json) and pushes pipeline state to the dashboard via WebSocket. Keeping pipeline updated is what makes the stepper UI show real-time progress.
After completing a step and updating directive.json, immediately read the next step's doc from the routing table below and execute it. Do NOT stop, do NOT pause, do NOT ask for confirmation between steps. The pipeline is designed to run end-to-end in a single pass.
STOP gates — the only points where you must stop and wait for the CEO:
clarification — heavyweight/strategic: STOP and present synthesized intent for CEO verification. Lightweight/medium: still run the step (synthesize intent) but auto-approve without stopping. Do NOT skip this step — the verified_intent output feeds the COO planner.approve — heavyweight/strategic: STOP and present plan for CEO approval. Lightweight/medium: auto-approve without stopping.completion — all weights. The CEO must approve, amend, extend, or redirect the directive.At every other step, transition directly to the next step without delay. If a step is skipped for the current weight class (brainstorm for lightweight/medium), set its status to "skipped" in directive.json and advance to the next step.
| # | Step ID | Doc | Purpose | Depends On |
|---|---|---|---|---|
| 1 | triage | 00-delegation-and-triage.md | Triage directive weight + select process | — |
| 2 | checkpoint | 01-checkpoint.md | Check for existing checkpoint, resume if found | — |
| 3 | read | 02-read-directive.md | Read directive file + create directive.json | triage |
| 4 | context | 03-read-context.md | Read all context files before planning | read |
| 5 | audit | 06-technical-audit.md | Technical codebase audit | context |
| 6 | brainstorm | 04-brainstorm.md | Approach brainstorm (includes challenge for heavyweight/strategic) | audit |
| 7 | clarification | 04b-clarification.md | Synthesize verified intent (auto-approve for lightweight/medium) | audit |
| 8 | plan | 05-planning.md | COO strategic planning | clarification |
| 9 | approve | 07-plan-approval.md | Present plan to CEO for approval | plan |
| 10 | project-brainstorm | 07b-project-brainstorm.md | CTO + builder decompose projects into tasks with DOD | approve |
| 11 | setup | 08-worktree-and-state.md | Worktree isolation + directive state init | project-brainstorm |
| 12 | execute | 09-execute-projects.md | Execute all tasks (phases, agents, UX) | setup |
| 13 | review-gate | 09-execute-projects.md | Review verification gate (end of doc) | execute |
| 14 | wrapup | 10-wrapup.md | OKRs, follow-ups, stale doc detection, digest, lessons, report | review-gate |
| 15 | completion | 11-completion-gate.md | CEO completion gate -- approve, amend, extend, or redirect | wrapup |
| Doc | Content |
|---|---|
| plan-schema.md | COO plan output JSON schema |
| audit-output.md | Architect output JSON schema (design recommendations — second phase of two-agent audit) |
| investigation-output.md | QA Engineer's investigation output JSON schema (pure data — first phase of two-agent audit) |
| checkpoint.md | Checkpoint JSON schema (deprecated — merged into directive-json.md) |
| directive-json.md | Directive JSON schema (THE source of truth — includes pipeline progress for dashboard) |
| brainstorm-output.md | Brainstorm output JSON schema (proposals + rebuttals + challenge) |
| Doc | Content |
|---|---|
| planner-prompt.md | Full COO planning prompt |
| investigator-prompt.md | Investigation prompt template for the QA Engineer (pure data gathering — first phase of audit) |
| architect-prompt.md | Architect prompt template (design recommendations — second phase of audit) |
| auditor-prompt.md | Combined audit prompt for the CTO (single-agent path for simple tasks) |
| brainstorm-prompt.md | Brainstorm agent prompt template (Phase 1 proposals + challenge + Phase 2 deliberation) |
| digest.md | Digest report template |
| Doc | Content |
|---|---|
| casting-rules.md | Agent casting: delegation, auditing, reviewing, specialists |
| phase-definitions.md | Phase building blocks + common patterns |
| scope-and-dod.md | Scope format + Definition of Done rules |
| failure-handling.md | Failure handling table |
| Script | Content |
|---|---|
| validate-cast.sh | Mechanical casting validation — checks reviewer present, builder != reviewer, complex/moderate has C-suite reviewer, no self-review of own prompts, depends_on valid, no circular deps |
| validate-project-json.sh | Pre-execution gate — blocks execute step if project.json missing or incomplete (no tasks, no DOD, no scope) |
| detect-stale-docs.sh | Post-directive — scans docs for references to modified files, flags potentially stale docs |
| validate-gate.sh | Pipeline step gate — validates prerequisites before advancing to next step |
| validate-reviews.sh | Review-gate hard gate — blocks completion if reviews missing, detects self-review and self-certification |
© andrew-yangy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 33 other files in .claude/skills/directive of andrew-yangy/gru-ai.
Open the folder on GitHubat commit 8fba479
Directive 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Directive this skillandrew-yangy/gru-ai | 155 | — | ~2.8k | Automated safety check: Warn | MIT | |
| Htmlvspecdisler/pi-agent-observability | 145 | — | ~4.7k | Automated safety check: Notes | MIT | |
| Rtl Aware DevelopmentSeeRay11/OpenFlow | 108 | — | ~1k | Automated safety check: Pass | MIT | |
| Agent Instructionsmurphytrueman/design-system-ops | 206 | — | ~2.3k | Automated safety check: Pass | MIT | |
| Planning With Files DeOthmanAdi/planning-with-files | 27k | — | ~3.7k | Automated safety check: Notes | MIT | |
| Cp Exploretangziwen/CubeMiniGame | 359 | — | ~535 | Automated safety check: Pass | MIT |
disler/pi-agent-observability
Creates a visual engineering implementation plan as a single self-contained HTML page saved to specs/<name.html — the plan authored directly in styled HTML, with one AI-generated diagram image per…
SeeRay11/OpenFlow
OpenCode Desktop should be RTL-aware. An agent skill from SeeRay11/OpenFlow.
murphytrueman/design-system-ops
Write the AGENTS.md that tells coding agents how to use this design system: where things live, sourced rules, how to check work, what not to do; Claude, Cursor or Copilot pointers on request.
OthmanAdi/planning-with-files
Persistente dateibasierte Planung für mehrstufige Arbeit mit KI-Agenten.
tangziwen/CubeMiniGame
Explore and clarify a prospective CodePlan before writing design.md.
OthmanAdi/planning-with-files
用于多步骤 AI 代理工作的持久化文件规划系统。将 taskplan.md、findings.md 和 progress.md 保存在磁盘上,生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据;--replay 可输出有长度限制且由 nonce…
andrew-yangy/gru-ai
Provides comprehensive code review guidance for React 19, Vue 3, Rust, TypeScript, Java, Python, and C/C++.
andrew-yangy/gru-ai
Full website SEO audit with parallel subagent delegation. An agent skill from andrew-yangy/gru-ai.
andrew-yangy/gru-ai
Structured brainstorm — from quick Socratic refinement to full C-suite strategy sessions.
andrew-yangy/gru-ai
Internal codebase and operations health check — the CTO scans technical health, the COO checks operational health.
andrew-yangy/gru-ai
CEO dashboard with progressive disclosure — 3 tiers: headline (5 lines, default), summary (per-goal detail), deep (full weekly analysis).
andrew-yangy/gru-ai
Pipeline end-to-end smoke test -- creates a trivial directive, runs it through /directive, validates every pipeline step, and reports pass/fail with evidence.
Categories
Execute work through the directive pipeline — evaluate, plan, cast agents, build, review, and report. Directive is an agent skill from andrew-yangy/gru-ai. Execute work through the directive pipeline — evaluate, plan, cast agents, build, review, and report.
Directive fits situations like: the user requests non-trivial work that goes beyond a one-liner fix.
Run `npx skills add andrew-yangy/gru-ai --skill directive -a claude-code`. Or copy the skill folder (.claude/skills/directive in andrew-yangy/gru-ai) into .claude/skills/directive in your project. Claude Code loads it when a task matches its description.
Run `npx skills add andrew-yangy/gru-ai --skill directive -a codex`. Or copy the skill folder (.claude/skills/directive in andrew-yangy/gru-ai) into .agents/skills/directive in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add andrew-yangy/gru-ai --skill directive -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/directive, .gemini/skills/directive, .github/skills/directive and .opencode/skills/directive in your project.
SKILL.md names no scripts, command-line tools or credentials: Directive is instructions for the agent only.
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.
Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.
Directive is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Directive: Htmlvspec (disler/pi-agent-observability, 145 stars), Rtl Aware Development (SeeRay11/OpenFlow, 108 stars), Agent Instructions (murphytrueman/design-system-ops, 206 stars) and Planning With Files De (OthmanAdi/planning-with-files, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
andrew-yangy (a GitHub user) maintains it in andrew-yangy/gru-ai, which has 155 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on March 11, 2026.
Source: andrew-yangy/gru-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.