sinas-skills

Skills and a CLI for AI coding agents (Claude Code, Cursor, etc.) building on Sinas.

Two skills — plain markdown your coding agent reads — and one CLI:

There is deliberately no app scaffolding here. sinas init drops the skills into any existing repo's .claude/skills/ plus a starter sinas-package.yaml; your agent does the rest in whatever stack the project already uses.

# In your project (Node 18+):
npx @sinas/cli@latest init      # skills + starter package file
npx @sinas/cli@latest login     # instance URL + admin API key → .sinas/config.json

Pin @latest (or npm i -g @sinas/cli@latest once). Plain npx @sinas/cli runs an older sinas already on your PATH or in the npx cache instead of fetching the current release — which silently gets you the retired scaffolding flow.

(Or from a checkout of this repo: npm install && npm run build, then node packages/cli/bin/sinas.js ….)

Create the admin API key in the Sinas console under Settings → API keys (needs management permissions). Then ask your coding agent for what you want — "add a pipeline that syncs deals nightly", "build a review screen for the triage agent" — and it will use the skills.

The authoring loop the agent follows:

sinas add <type> <name>   # stub a resource in sinas-package.yaml
sinas validate            # after every edit
sinas preview             # dry-run diff
sinas install             # apply (asks for confirmation)
sinas status              # manifest health: resources + permissions

Tracks Sinas 0.4.x (pipelines, provider batch mode, agent provider overrides, OIDC token verification). Instances report their version in the X-Sinas-Version response header and at GET /info. The instance's /openapi.json is always the authority when details differ.

AGPL-3.0