Using the AI agent skill

Install the using-smartspectra agent skill in Claude Code or Codex, and build pulse and breathing apps with an AI coding assistant.

Important: SDK metrics are offered for general wellness and informational purposes only. SDK metrics have not been cleared by the FDA and may not be used for medical diagnosis or treatment.

using-smartspectra is an Agent Skill — a small guide that an AI coding assistant loads on demand to build apps with the SmartSpectra SDK. It teaches the API model (getting a key, the config → start/stop lifecycle, choosing metrics) and points the assistant at these docs for exact, current per-platform detail.

It is one portable SKILL.md in the standard Agent Skills format, so the same skill works in both Claude Code and OpenAI Codex. Both are hosted in the public repo Presage-Security/SmartSpectra.

Install in Claude Code

Add the repo as a plugin marketplace, then install the plugin:

/plugin marketplace add Presage-Security/SmartSpectra
/plugin install smartspectra-sdk@smartspectra

Run /plugin to confirm smartspectra-sdk is enabled. The skill then loads automatically when a task matches it; there is nothing else to configure.

Install in Codex

Install the skill straight from the repo with the Codex skill installer:

$skill-installer Presage-Security/SmartSpectra/.agents/skills/using-smartspectra

Codex detects newly installed skills automatically; restart Codex if it does not appear. When you are working inside a clone of the repo, Codex also discovers the skill automatically from .agents/skills/.

Install anywhere else

For any other assistant, the same skill is served straight from this site:

https://smartspectra.presagetech.com/skill.md

Point your tool at that URL, or paste the file into the assistant's instructions. It is the identical SKILL.md the plugin installs, so there is nothing to keep in sync.

Reading these docs as markdown

The skill has your assistant read this site for exact API detail, and every page here is available as markdown — append .md to any documentation URL:

https://smartspectra.presagetech.com/docs/swift/metrics.md

llms.txt indexes every page with a one-line description, and llms-full.txt is the whole corpus in one file. Assistants generally find these on their own; the URLs are here for when you want to hand one over directly.

Use it

Describe what you want to build and let the assistant drive:

Using the SmartSpectra SDK, build a minimal app that measures and displays my pulse.

The skill guides the assistant to the correct API for your platform — C++, Swift/iOS, Kotlin/Android, or Node — and to the matching pages in these docs for exact signatures, install steps, and sample apps. You review and run the code it writes, the same as any other assistant output.

What you need

An API key from the Developer Admin Portal — the assistant will use it to build a working app. The skill itself does not fetch a key for you, but if you also connect the SmartSpectra MCP Server the assistant can retrieve it from your account. Otherwise set it as described on your platform's setup page.
Network access for the assistant while it works: the skill has the assistant read the live docs at smartspectra.presagetech.com for exact API detail. Without web access it can still apply the general model but cannot look up precise signatures.