Synatra Skills

This repository contains the Synatra assistant skills for agents that can load filesystem-based skills, including Codex, Claude Code, and OpenClaw.

Synatra is the rebrand of the assistant skill bundle formerly published as atomic-nebula-skills. The skill IDs are now synatra-*. The backend API host and the atomicnebula-webhook OpenClaw plugin keep their existing names until the product-side rebrand lands, so existing credentials keep working.

The canonical source is the skills/ directory in the private CirceAura monorepo. This repo is a published copy. Consumer-specific folders are included as convenience views so agents can install from the layout they expect without maintaining 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

skills/                 Canonical Synatra skills and shared helpers
.agents/skills/         Codex-style view, linked to skills/
.claude/skills/         Claude Code-style view, linked to skills/
openclaw-skills/        OpenClaw-style view, linked to skills/
install.sh              Local installer for Codex, Claude Code, or OpenClaw
MAINTAINERS.md          Update workflow for this public bundle

Install

Clone the repository, then install for the agent you use.

Codex:

./install.sh --target codex

Claude Code:

./install.sh --target claude

OpenClaw:

./install.sh --target openclaw

Install to all 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.

Install From A Repo Path

Agents that can install skills directly from a repo path can use the canonical paths under skills/. Always include skills/shared with any Synatra skill, because the shell helpers resolve workspace and API configuration through shared/resolve-env.sh.

For example, install Tasks with:

skills/synatra-tasks
skills/shared

Or install multiple skills from the same repository:

skills/synatra-tasks
skills/synatra-calendar
skills/synatra-email
skills/shared

Configure Access

The skills call the Synatra assistant API. Configure credentials by either setting environment variables or creating a workspace config file.

Environment variables:

export SYNATRA_API_KEY="..."
export SYNATRA_BASE_URL="https://convex-actions.circeaura.com"

The legacy ATOMICNEBULA_API_KEY / ATOMICNEBULA_BASE_URL variables are still honored as a fallback.

Workspace config:

~/.config/circeaura/assistant-workspaces.json

After credentials are configured, list available workspaces with:

~/.codex/skills/shared/an-env-list.sh

Use the equivalent installed path for Claude Code or OpenClaw if you installed there instead.

Usage

Ask your agent to use a Synatra skill, for example:

• "Use Synatra to show my tasks."
• "Use Synatra to draft an email."
• "Use Synatra to show my calendar tomorrow."

Most scripts accept --env <workspace> to target a configured workspace:

~/.codex/skills/synatra-tasks/scripts/an-tasks.sh --env dev list

Included Skills

• synatra-attachments
• synatra-attention
• synatra-calendar
• synatra-capture
• synatra-companies
• synatra-contacts
• synatra-context
• synatra-digest
• synatra-email
• synatra-forms
• synatra-leads
• synatra-meetings
• synatra-notebook
• synatra-pipelines
• synatra-products
• synatra-projects
• synatra-social
• synatra-task-write
• synatra-tasks
• synatra-teams