@getrheo/rheo-skill

Current release: 3.0.0 on npm (PLATFORM_SDK_VERSION in scripts/publish-package-registry.mjs). Public source: getrheo/rheo-skill (mirrored from this private monorepo via pnpm extract:oss-repos).

Source and build tooling for the rheo agent skill — a single, self-contained skill with two sub-skills. Rheo is one SDK and one Customer across Analytics, Convert, and Engage.

• rheo/rheo-best-practices — how to install and wire that SDK on Expo, bare React Native, and React web (SwiftUI / Flutter SDK install is coming soon): product analytics, Convert flows, Engage identify / track, integrations, and auth. Pure guidance, no scripts.
• rheo/rheo-flow-import — the Convert authoring path: analyze an existing mobile flow and export it as a compliant Rheo FlowManifest, plus self-contained node scripts (audit, scaffold, validate, audit-publish, normalize, summary, profile).

The deliverable is rheo/

The installable artifact is the rheo/ directory. It is fully self-contained: the rheo-flow-import scripts run with plain node and need no pnpm install, because the validation/scaffold engine, zod, @getrheo/contracts, and @getrheo/flow-runtime are bundled into rheo/rheo-flow-import/scripts/lib/rheo-cli.mjs at build time.

rheo/
├── SKILL.md                      # router → rheo-best-practices / rheo-flow-import
├── rheo-best-practices/
│   ├── SKILL.md
│   ├── references/               # product-model, analytics, engage, react-web,
│   │                             #   install-* , integrations, implement-workflow, troubleshooting
│   └── examples/               # install snippets (RN, SwiftUI, web)
└── rheo-flow-import/
    ├── SKILL.md
    ├── references/               # import-workflow, flow-spec, capabilities (generated), manifest-rules,
    │                             #   layer-schema-pitfalls, publish-gates, *-source-patterns, carousel/font/i18n/animation
    ├── examples/                 # valid manifests + flow-spec.example.json
    └── scripts/
        ├── *.mjs                 # thin wrappers (import runCli from lib)
        └── lib/rheo-cli.mjs      # GENERATED self-contained bundle (committed)

Source layout (this package)

• src/ — TypeScript engine (CLI, audit analyzers, scaffold, publish gates, validation, profile fetch). Source of truth for the bundle.
• scripts/build-skill.ts — esbuild bundler → rheo/rheo-flow-import/scripts/lib/rheo-cli.mjs.
• src/capabilities/generateCapabilities.ts — regenerates rheo/rheo-flow-import/references/capabilities.md from @getrheo/contracts.
• test/ — vitest suite (scaffold structure, publish gates, validation, capabilities drift, bundle smoke test).

Commands

pnpm --filter @getrheo/rheo-skill build          # gen:capabilities + bundle (run before committing)
pnpm --filter @getrheo/rheo-skill gen:capabilities
pnpm --filter @getrheo/rheo-skill bundle
pnpm --filter @getrheo/rheo-skill test
pnpm --filter @getrheo/rheo-skill typecheck
pnpm --filter @getrheo/rheo-skill validate:examples
pnpm --filter @getrheo/rheo-skill validate:skill-format   # agentskills.io frontmatter (skills-ref)

validate:skill-format installs the official skills-ref validator into a local .venv-skills-ref (gitignored) and checks rheo/, rheo/rheo-best-practices/, and rheo/rheo-flow-import/. Requires Python 3.11+. Set SKILLS_REF_SKIP=1 to skip (e.g. environments without Python). The same check runs in pnpm test via test/skillFormat.test.ts.

Run build after any change under src/ or to @getrheo/contracts / @getrheo/flow-runtime. When rheo-skill paths change, CI runs build and fails if rheo-cli.mjs or capabilities.md are not committed (rheo-skill.yml).

Manifest profile

rheo-flow-import fetches the latest LLM-friendly Manifest Agent Profile from https://docs.getrheo.io/docs/md/developer-guide/agent-manifest-profile, falling back to rheo/rheo-flow-import/references/manifest-agent-profile-fallback.md offline.

Compatibility

• Manifest schema version: 7
• SDK surfaces this skill installs today: React Native (Expo and bare), React web (@getrheo/react). SwiftUI / Flutter SDK install is coming soon; SwiftUI flow import remains in rheo-flow-import
• Engage identify and track ship on web (@getrheo/react) and React Native
• Requires Node.js 20+