> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorgx.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> OrgX skill packs — reusable Claude instructions that unlock specialized agent workflows from any MCP client.

**Skills** are reusable instruction sets that extend what Claude (and other MCP clients) can do with OrgX. Each skill pack gives your AI client a complete workflow — from context gathering to artifact output — for a specific OrgX task.

<Info>
  Skills live in the [useorgx/skills](https://github.com/useorgx/skills) public repository. The wizard CLI installs them locally with one command:

  ```bash theme={"dark"}
  npx @useorgx/wizard@latest skills add
  ```
</Info>

<Info>
  In the OrgX app and cloud runtime, `skills/` is a generated, pinned cache of
  `useorgx/skills`, not a second authoring surface. Runtime reads stay local and
  network-free; CI uses `pnpm skills:check-source` to prove the cache still
  matches `useorgx/skills@<sha>`. Use `SKILL_PACKS_DIR` only for explicit local
  overrides.
</Info>

***

## How Skills Work

When you install an OrgX skill pack, the wizard writes a `SKILL.md` file into your local Claude configuration at `.claude/skills/orgx/`. Claude picks this up as context for any conversation in that directory, giving it:

* The right sequence of MCP tool calls to call
* Domain-specific quality rules and artifact contracts
* Evidence proof requirements (durable links, not OrgX wrapper pages)
* Trigger patterns so skills activate on natural language cues

For Cursor users, the wizard also writes `.cursor/rules/orgx.md` with equivalent rules.

***

## Source of Truth and Runtime Cache

Canonical authoring happens in [useorgx/skills](https://github.com/useorgx/skills).
The OrgX app vendors a generated cache at `skills/` so cloud agents can load skill
instructions without fetching GitHub during an agent run.

* `pnpm skills:sync-source` refreshes the cache from `useorgx/skills` and updates
  `skills/.source.lock.json`.
* `pnpm skills:check-source` fails when any managed skill file drifts from the
  pinned source ref.
* App-only skills remain explicit local overlays in `skills/.source.lock.json`.
* `SKILL_PACKS_DIR=/path/to/skills` is still supported for deliberate local
  development overrides.

The portable skill format is:

```text theme={"dark"}
skill-id/
  SKILL.md       # required cross-runtime instructions
  skill.toml     # required OrgX runtime metadata
  reference/     # optional, loaded on demand
  examples/      # optional, loaded on demand
  scripts/       # optional validators/helpers
  evaluations/   # optional CI/eval fixtures
```

***

## Installing Skills

### Default Starter Pack

```bash theme={"dark"}
npx @useorgx/wizard@latest skills add
```

Installs the four default packs: `morning-briefing`, `initiative-kickoff`, `bulk-create`, `nightly-recap`.

### Specific Packs

```bash theme={"dark"}
npx @useorgx/wizard@latest skills add engineering-agent orchestrator-agent
```

### All Packs

```bash theme={"dark"}
npx @useorgx/wizard@latest skills add morning-briefing nightly-recap \
  initiative-kickoff initiative-protocol workstream-protocol milestone-protocol task-protocol \
  bulk-create engineering-agent product-agent marketing-agent sales-agent \
  design-agent design-audit operations-agent orchestrator-agent
```

***

## Available Skills

### Daily Operations

<CardGroup cols={2}>
  <Card title="morning-briefing" icon="sun">
    **Trigger**: "morning briefing", "daily status", "what's pending", "what should I work on first?"

    Generates a concise daily report with value signals, pending decisions (critical first), blocked tasks grouped by initiative, and agent activity. Calls `orgx_recommend` + `orgx_search` for decisions and blocked tasks.
  </Card>

  <Card title="nightly-recap" icon="moon">
    **Trigger**: "nightly recap", "daily summary", "what happened today", "end of day report"

    Summarizes the day's OrgX activity — completed tasks, decisions made, agent work, and any errors that need attention. Good for async standup notes or end-of-day logs.
  </Card>
</CardGroup>

***

### Initiative Management

<CardGroup cols={2}>
  <Card title="initiative-kickoff" icon="rocket">
    **Trigger**: "kickoff", "new initiative", "start project", "create initiative for", "set up \[goal]"

    Transforms a one-line goal into a full OrgX initiative: parses the objective, checks for duplicates, creates the initiative with milestones and workstreams, assigns agent domains, and optionally launches immediately.

    Not for: updating existing initiatives, simple task creation.
  </Card>

  <Card title="initiative-protocol" icon="sitemap">
    **Trigger**: managing an active OrgX initiative lifecycle

    Handles creation, decomposition into workstreams and streams (with DAG dependencies), launch, monitoring, and completion. Reference protocol for any skill that needs to touch initiative state.
  </Card>

  <Card title="workstream-protocol" icon="arrow-right-arrow-left">
    **Trigger**: workstream creation, management, stream coordination

    Covers workstream creation, stream setup with agent domain and `auto_continue`, dependency wiring, and health checks. Used internally by `initiative-protocol` and `orchestrator-agent`.
  </Card>

  <Card title="milestone-protocol" icon="flag">
    **Trigger**: milestone creation, scheduling, gate checking

    Manages milestone definitions with due dates and completion gates. Coordinates with workstreams to track progress toward milestones.
  </Card>

  <Card title="task-protocol" icon="check-square">
    **Trigger**: individual task execution within a workstream

    Handles task lifecycle: start → execute → verify → complete. Emits telemetry at each phase, follows domain-specific workflows, and submits learnings on completion.
  </Card>
</CardGroup>

***

### Domain Agent Skills

These skills give your MCP client the same specialized expertise as OrgX's built-in agents. Each produces evidence-based artifacts with durable proof links.

<AccordionGroup>
  <Accordion title="engineering-agent" icon="code">
    **Domain**: Technical decisions, implementation risk, code quality

    **Artifacts produced**: RFCs, ADRs, code review summaries, incident postmortems, tech debt inventories, capacity plans, runbooks, migration playbooks, dependency audits, performance budgets, architecture docs (any C4 level), threat models, SLO definitions, build-vs-buy analyses

    **Proof rules**: GitHub PR/commit/blob permalinks, public docs URLs, or absolute file paths only. No OrgX wrapper pages.

    ```
    # Example triggers
    "write an RFC for migrating our auth system"
    "review this PR for security issues"
    "create a runbook for database failover"
    ```
  </Accordion>

  <Accordion title="product-agent" icon="lightbulb">
    **Domain**: Problem framing, user value, prioritization, measurable outcomes

    **Artifacts produced**: PRDs, initiative plans, product canvases, user research briefs, competitive analyses, feature prioritization matrices, pivot evaluations, metric dashboard specs, launch readiness checklists

    ```
    # Example triggers
    "write a PRD for the new onboarding flow"
    "prioritize these features for Q2"
    "competitive analysis vs. [competitor]"
    ```
  </Accordion>

  <Accordion title="marketing-agent" icon="megaphone">
    **Domain**: Campaign planning, content creation, growth, SEO/AEO

    **Artifacts produced**: Campaign briefs, landing page copy, blog posts, email sequences, social content calendars, SEO/AEO keyword plans, go-to-market playbooks, press releases, brand messaging guides

    ```
    # Example triggers
    "create a campaign brief for our product launch"
    "write a blog post about [topic]"
    "draft an email nurture sequence for trial users"
    ```
  </Accordion>

  <Accordion title="sales-agent" icon="handshake">
    **Domain**: Pipeline, outreach, objection handling, competitive positioning

    **Artifacts produced**: Outreach sequences, qualification frameworks, competitive battlecards, proposal templates, win/loss analyses, ICP definitions, discovery call scripts

    ```
    # Example triggers
    "create an outreach sequence for enterprise prospects"
    "build a battlecard for [competitor]"
    "write a discovery call script"
    ```
  </Accordion>

  <Accordion title="design-agent" icon="palette">
    **Domain**: UX rationale, design decision support, UI briefs

    **Artifacts produced**: UX rationale documents, design briefs, component specs, accessibility assessments, user flow diagrams, design system contribution guidelines

    ```
    # Example triggers
    "write a UX rationale for the new checkout flow"
    "create a design brief for the mobile navigation"
    ```
  </Accordion>

  <Accordion title="operations-agent" icon="gear">
    **Domain**: Process operations, incident management, runbooks

    **Artifacts produced**: Incident reports, process playbooks, runbooks, SOC procedures, vendor evaluations, operational risk assessments, team capacity reports

    ```
    # Example triggers
    "create a runbook for on-call escalation"
    "write an incident report for last night's outage"
    "evaluate [vendor] for our data pipeline"
    ```
  </Accordion>

  <Accordion title="orchestrator-agent" icon="network-wired">
    **Domain**: Cross-domain execution coordination

    **Artifacts produced**: Initiative plans, delegation messages, synthesis reports, retrospectives, dependency audits, resource allocations, risk registers, stakeholder updates, program status reports

    The orchestrator never does domain work itself — it coordinates, sequences, unblocks, and synthesizes across other agents.

    ```
    # Example triggers
    "coordinate the Q2 product and marketing launch"
    "create a cross-team initiative for [goal]"
    "synthesize this week's agent outputs into a status report"
    ```
  </Accordion>
</AccordionGroup>

***

### Specialized Skills

<CardGroup cols={2}>
  <Card title="design-audit" icon="magnifying-glass">
    **Trigger**: `/design-audit <target_path_or_url> [reference_urls...]`

    Applies cognitive psychology, Gestalt theory, and principles from Rams, Tufte, Norman, and others to audit any UI surface. Outputs a scored assessment with prioritized improvements. Minimum target: 9/10 per pass.
  </Card>

  <Card title="bulk-create" icon="list-check">
    **Trigger**: "bulk create", "create tasks from list", "import checklist", "batch create"

    Parses markdown checklists, bullet lists, or numbered lists and creates multiple OrgX entities in batch. Detects priorities from keywords and wires up dependencies for nested items.
  </Card>
</CardGroup>

***

## Proof Rules (All Skills)

Every domain skill enforces these artifact proof rules:

* **Durable sources only**: GitHub PR/commit/blob permalinks, public URLs, or absolute file paths (`/path/to/file` or `file://...`)
* **No OrgX wrapper pages**: `/live/...`, `/artifacts/...`, and `/console/...` are dashboards, not evidence
* **`preview_markdown` is supporting context**: it does not replace a durable proof URL

These rules exist so artifacts remain verifiable outside OrgX itself.

***

## Writing Custom Skills

Skills are plain Markdown files with a YAML frontmatter header. Place them in `.claude/skills/` in your project directory:

```markdown theme={"dark"}
---
name: my-custom-skill
description: |
  What this skill does and when to use it.
  Triggers on: "specific phrases the user might type"
---

# My Custom Skill

## Workflow

1. Gather context with `mcp__orgx__orgx_search`
2. ...
```

See the [useorgx/skills](https://github.com/useorgx/skills) repo for examples.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Wizard CLI" icon="terminal" href="/guides/wizard-cli-onboarding">
    Full CLI reference for installing and managing skills.
  </Card>

  <Card title="Agent Quickstart" icon="robot" href="/agent-ops/agent-quickstart">
    Run your first agent task with skills wired in.
  </Card>

  <Card title="Agent Recipes" icon="book-open" href="/agent-ops/agent-recipes">
    Pre-built workflows combining multiple skills.
  </Card>

  <Card title="MCP Tools" icon="server" href="/api/mcp-tools">
    Full reference for the tools skills call under the hood.
  </Card>
</CardGroup>
