What makes Fulcra Annotations notable?

2.2K downloads. Trust evidence available

How should Fulcra Annotations be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Fulcra Annotations

Create, list, update, and record Fulcra annotations through the Fulcra Life API. Use when a user asks to log an annotation, create an annotation button/defin...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.2k

Updated

Oct 9, 2026

Version

1.0.16

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.2K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.2K downloadsadoption · observed Oct 9, 2026
Latest release: 1.0.16release · observed Jul 12, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s177v15fjt9pn5v99vms8sqkfn86vdwr:fulcra-annotations

Install using `clawhub skill install s177v15fjt9pn5v99vms8sqkfn86vdwr:fulcra-annotations` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/arc-claw-bot/fulcra-annotations before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-arc-claw-bot-fulcra-annotations/snapshot"

Documentation

CLAWHUB

146,047 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: fulcra-annotations
description: Create, list, update, and record Fulcra annotations through the Fulcra Life API. Use when a user asks to log an annotation, create an annotation button/definition, record a moment/boolean/numeric/scale annotation, inspect annotation IDs/source IDs, or build agent workflows that write Fulcra annotation events.
metadata: {"openclaw":{"requires":{"bins":["python3","uv"]},"permissions":["shell:uv-tool-run-fulcra-api","network:https://api.fulcradynamics.com","env:FULCRA_ACCESS_TOKEN","env:FULCRA_HOME","env:FULCRA_AGENT_SOURCE"]}}
---

# Fulcra Annotations

Use this skill when the user wants an agent to create, record, or verify Fulcra annotations.

Fulcra gives agents and their humans scoped, secure access to read and write real-world context and shared human/agent memory: attention, events, location, calendar, health, wearables, and other streams. Use this skill for the write side of that loop: creating reusable annotation definitions and recording user-approved moments or values.

Agents should use the bundled script first. Do not hand-write curl calls unless the script is missing a required capability, because the script keeps tokens out of chat, builds the Fulcra ingest payload consistently, and performs readback verification.

## First-Run Onboarding Pattern

When a user is new to Fulcra annotations, optimize for a quick useful loop: choose a concrete thing to track, create one or two definitions, record one real data point, verify it, and show the user what now exists.

1. Start with a short, grounded prompt. Do not ask only "what do you want to track?"; offer 2-3 specific options based on the user's context, such as a daily focus score, coffee count, symptom check, workout effort, or a moment log for important events.
2. Check auth only after there is a clear use case. If `uv tool run fulcra-api user-info` fails, run `uv tool run fulcra-api auth login`, keep the process alive, and send only the device URL/code through the trusted user channel.
3. Translate the use case into 1-3 annotation definitions. Prefer the simplest type that captures the signal: `moment` for occurrences, `boolean` for yes/no, `numeric` for counts or measured quantities, and `scale` for subjective ratings.
4. Run `list` before `create` to avoid duplicates. If creating multiple definitions, save the returned `annotation.id`, `source_id`, and type from each create result in your working notes so the next record step does not need another lookup.
5. Ask one direct question for the first record, then call `record --id ...` with `--value` when needed. Treat success as confirmed only when `verified_matches >= 1`.
6. For the handoff, summarize the definition names, the exact timestamp written, and one natural next action. If generating a demo artifact, use synthetic or explicitly approved real data and keep private records out of chat.

## Core Concepts

- **Annotation definition**: the reusable button/metric definition, such as `Focus` o

README.md

# Fulcra Annotations

Create Fulcra annotation definitions and record annotation events from an agent workflow.

Fulcra gives agents and their humans scoped, secure access to read and write real-world context and shared human/agent memory: attention, events, location, calendar, health, wearables, and other streams. This skill is the write path: agents can create reusable annotation definitions and record moments, booleans, numeric values, and scale ratings after user approval.

## What It Does

- Lists existing Fulcra annotation definitions.
- Creates, updates, and deletes annotation definitions, including definition-level tags.
- Records annotation events, including historical timestamps.
- Supports moment, boolean, numeric, and scale annotations.
- Supports record-level tags for individual logged events.
- Verifies writes by reading the event back after ingest.

## Requirements

- Python 3.11 or newer.
- Authenticated Fulcra account for the target user. No API key is required.
- `uv tool run fulcra-api auth login` completed, or `FULCRA_ACCESS_TOKEN` supplied by a trusted secret manager.

Fulcra accounts can be created through the CLI auth flow and include 5 GB of storage free forever. Users who want biometrics, location, calendar, and other mobile context can install the Context iOS app and sign in with the same account; the app uses the same free storage and is no longer subscription gated. Android is coming soon.

For remote agents, run `uv tool run fulcra-api auth login` on the agent host, keep it polling, and surface only the printed device authorization URL and user code to the intended user in chat through the active trusted user channel. The user can approve from any browser on any device. Never send access tokens or credential files.

If credentials live outside the process home, set `FULCRA_HOME` to the home directory that contains the Fulcra CLI credentials. Set `FULCRA_CLI_COMMAND` only when you need to override the default `uv tool run fulcra-api` command.

## Quick Start

```bash
python3 skills/fulcra-annotations/scripts/fulcra_annotations.py list
```

Create a reusable moment annotation definition:

```bash
python3 skills/fulcra-annotations/scripts/fulcra_annotations.py create \
--type moment \
--name "Asked Agent to Do Something New" \
--description "Logged when the user asks the agent to try a new category of work" \
--tag agent \
--tag new-task
```

Record a moment now:

```bash
python3 skills/fulcra-annotations/scripts/fulcra_annotations.py record \
--name "Asked Agent to Do Something New" \
--note "User asked for a new annotation workflow" \
--tag new-task
```

Record a historical moment:

```bash
python3 skills/fulcra-annotations/scripts/fulcra_annotations.py record \
--name "Asked Agent to Do Something New" \
--recorded-at "2026-05-15T10:00:00-04:00" \
--note "Backfilled from user request" \
--tag backfill
```

The script returns JSON. Treat the write as confirmed only when `verified_matches` is at l

_meta.json

{
  "ownerId": "kn7bjcdhk2dyk0wc92njxshp9d80939t",
  "slug": "fulcra-annotations",
  "version": "1.0.16",
  "publishedAt": 1783854667166
}

references/api-notes.md

# Fulcra Annotation API Notes

Loaded only when schema details matter.

## Definition Endpoints

The public OpenAPI document is served from:

`https://api.fulcradynamics.com/openapi.json`

Documented annotation definition endpoints:

- `GET /user/v1alpha1/annotation`
- `POST /user/v1alpha1/annotation`
- `GET /user/v1alpha1/annotation/{annotation_id}`
- `PUT /user/v1alpha1/annotation/{annotation_id}`
- `DELETE /user/v1alpha1/annotation/{annotation_id}`
- `POST /user/v1alpha1/annotation/{annotation_id}/cancel_deletion`

Supported definition types:

- `moment`
- `boolean`
- `numeric`
- `scale`
- `duration`
- `people`

## Event Ingest

The generic ingest endpoint is:

`POST /ingest/v1/record`

Payload shape:

```json
{
  "specversion": 1,
  "data": "{\"note\":\"optional note\",\"value\":4}",
  "metadata": {
    "data_type": "ScaleAnnotation",
    "recorded_at": "2026-05-14T19:30:00Z",
    "source": [
      "com.example.agent",
      "com.fulcradynamics.annotation.<annotation-id>"
    ],
    "tags": [],
    "content_type": "application/json"
  }
}
```

Observed readback data classes:

- Moment annotations: `/data/v1alpha1/event/MomentAnnotation`
- Duration annotations: `/data/v1alpha1/event/DurationAnnotation`
- Boolean annotations: `/data/v1alpha1/metric/BooleanAnnotation`
- Numeric annotations: `/data/v1alpha1/metric/NumericAnnotation`
- Scale annotations: `/data/v1alpha1/metric/ScaleAnnotation`

## Current Gaps

The beta CLI currently does not expose annotation write commands or Magic Link retrieval. Prefer the bundled REST script until upstream CLI support lands.

skill-card.md

## Description:

Create, list, record, and verify Fulcra annotation definitions and events through the Fulcra Life API.

This skill is ready for commercial/non-commercial use.

## Publisher:

[arc-claw-bot](https://clawhub.ai/user/arc-claw-bot)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agent operators use this skill to create Fulcra annotation definitions, record approved moment or metric annotations, and verify writes through readback.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Authentication depends on local Fulcra CLI execution and account credentials.

Mitigation: Install only with a trusted Fulcra account, API endpoint, and CLI supply chain; prefer a pinned reviewed CLI version or vetted local binary.

Risk: Broad FULCRA_CLI_COMMAND overrides could route authentication through an unintended executable.

Mitigation: Keep the default Fulcra CLI invocation when possible and avoid overrides unless the executable path has been reviewed.

Risk: Update, delete, bulk, or backfill workflows can change existing annotation state or create many records.

Mitigation: Require explicit user confirmation, use dry-run mode before writes, and use a reviewed admin or ledger-backed workflow for broad changes.

Risk: Fulcra records and tokens may contain private user data.

Mitigation: Do not print access tokens, credential files, capability URLs, or raw private records in chat or logs; share device authorization details only through the trusted user channel.

## Reference(s):

- [Fulcra Annotation API Notes](references/api-notes.md)
- [Fulcra API OpenAPI document](https://api.fulcradynamics.com/openapi.json)
- [ClawHub skill page](https://clawhub.ai/arc-claw-bot/skills/fulcra-annotations)

## Skill Output:

**Output Type(s):** [guidance, shell commands, configuration, JSON]

**Output Format:** [Markdown guidance with bash commands and JSON command results]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires Fulcra authentication and readback verification for confirmed writes.]

## Skill Version(s):

1.0.16 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 10h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.