Synatra Skills

This repository is the official Synatra plugin marketplace for Codex and Claude Code. It also contains a compatibility installer for OpenClaw and other agents that load filesystem-based skills directly.

The skill IDs are synatra-*. The packaged CLI treats the API as authoritative while retaining existing workspace aliases and OpenClaw credential profiles as migration inputs.

The canonical source is the skills/ directory in the private CirceAura monorepo. The self-contained published package lives at plugins/synatra/. Consumer-specific folders are convenience views over that package rather than separate copies.

Maintainers should read MAINTAINERS.md before changing this repository. It documents how this public bundle is synced from the private CirceAura assistant skill sources and what validation should run before each push.

Layout

plugins/synatra/        Versioned Codex and Claude plugin package
  skills/               Synatra skills plus hidden shared support
  bin/synatra           Bundled standalone CLI used by the skills
  assets/               Canonical Synatra marketplace artwork
.agents/plugins/        Codex marketplace catalog
.claude-plugin/         Claude marketplace catalog
.agents/skills/         Compatibility view linked to the plugin skills
.claude/skills/         Compatibility view linked to the plugin skills
openclaw-skills/        OpenClaw view linked to the plugin skills
install.sh              Compatibility installer for filesystem-only agents
MAINTAINERS.md          Update workflow for this public bundle
test.sh                 Plugin, clean-install, and bundled-CLI smoke test

Install

Synatra is published as an independent plugin marketplace. It does not need to be listed in an official plugin directory before Codex or Claude Code can install it.

Requirements:

• a Synatra personal key
• Node.js 22 or newer for the bundled CLI

Install the marketplace and plugin with your agent's native plugin manager.

Codex:

codex plugin marketplace add https://git.circeaura.com/synatra/synatra-skills.git
codex plugin add synatra@synatra

Claude Code:

claude plugin marketplace add https://git.circeaura.com/synatra/synatra-skills.git
claude plugin install synatra@synatra

Restart the agent or begin a new session after installation or upgrade.

Connect Synatra

The plugin contains its own Synatra CLI. Codex and Claude resolve and run that packaged CLI automatically; users do not need to install a global CLI, locate a plugin-cache directory, or invoke a shell helper.

In a new session, ask:

Use Synatra to securely connect my personal key, discover the workspaces it can access, and let me choose one.

The agent must use the CLI's authoritative workspace discover API before it trusts local workspace state. Local configuration is only a cache for routing aliases and the selected workspace. If discovery does not return a workspace, the personal key does not currently grant access to it.

Do not paste a personal key into ordinary chat or place it in a command-line argument. The CLI accepts credentials through its protected login flow or standard input and stores them in the operating system credential store.

Use Synatra

Ask for the business outcome rather than a command. For example:

• "Use Synatra to show my tasks."
• "Use Synatra to draft an email."
• "Use Synatra to show my calendar tomorrow."
• "Use Synatra to create a notebook item containing the word test."

The active skill discovers the granted workspace, verifies live capabilities, and then executes the canonical CLI operation. Writes still require explicit approval of the workspace and payload.

Update Or Remove

Codex update:

codex plugin marketplace upgrade synatra
codex plugin add synatra@synatra

Claude Code update:

claude plugin marketplace update synatra
claude plugin update synatra@synatra

Remove the plugin and marketplace:

# Codex
codex plugin remove synatra@synatra
codex plugin marketplace remove synatra

# Claude Code
claude plugin uninstall synatra@synatra
claude plugin marketplace remove synatra

Compatibility Installer

Clone the repository and use install.sh only when the agent does not support native plugins or when testing the filesystem-only fallback.

OpenClaw:

./install.sh --target openclaw

Install loose skills to all legacy default locations:

./install.sh --target all

Replace older installed copies:

./install.sh --target codex --force

Install into a custom skills directory:

./install.sh --target codex --dest /path/to/skills

Restart or reload the target agent after installation.

The installer places the bundled CLI beside the target skills/ directory. The skills resolve that copy automatically, so no global Synatra CLI installation is required.

Validate a checkout before publishing with:

./test.sh

Troubleshooting

• Workspace missing: ask the agent to run authoritative workspace discovery again. Do not fix access by editing the local cache.
• Authentication failed: reconnect the personal key through the packaged CLI login flow. Never send the key as a command argument.
• Plugin changes are not visible: update the marketplace and plugin, then start a new session.
• Marketplace blocked: an organization administrator may need to allow the repository in managed plugin settings.
• Filesystem-only agent: use the compatibility installer above; direct repo-path installation must include plugins/synatra/skills/.shared and the bundled plugins/synatra/bin/synatra CLI.

Included Skills

• synatra-activity-notes
• synatra-attachments
• synatra-attention
• synatra-calendar
• synatra-calls
• synatra-capabilities
• synatra-capture
• synatra-cms
• synatra-companies
• synatra-contacts
• synatra-context
• synatra-deals
• synatra-digest
• synatra-directory
• synatra-email
• synatra-entity-comments
• synatra-forms
• synatra-leads
• synatra-meetings
• synatra-notebook
• synatra-pipelines
• synatra-products
• synatra-projects
• synatra-segments
• synatra-social
• synatra-tasks
• synatra-teams
• synatra-theme-builder