← Back to Skills Marketplace
267
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install blinko-api
Description
Manage Blinko notes and blinkos from the command line. Use when you need to list, create, update, delete, or promote blinkos.
README (SKILL.md)
\r \r
Blinko\r
\r Use the Blinko API from Python with host and token loaded from OS environment variables.\r \r
Usage\r
\r Set environment variables in your OS/session:\r \r
BLINKO_HOST=http://127.0.0.1:1111/api\r
BLINKO_TOKEN=your_token_here\r
```\r
\r
### List notes\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py list-notes\r
```\r
\r
### Get a note\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py get-note NOTE_ID\r
```\r
\r
### Upsert a note\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py upsert-note --content "My note content"\r
```\r
\r
### Delete a note\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py delete-note NOTE_ID\r
```\r
\r
### List blinkos\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py list-blinkos\r
```\r
\r
### Upsert a blinko\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py upsert-blinko --content "Quick thought"\r
```\r
\r
### Promote blinko to note\r
\r
```bash\r
python3 {baseDir}/scripts/blinko_client.py promote-blinko BLINKO_ID\r
```\r
\r
## Notes\r
\r
- Reads `BLINKO_HOST` and `BLINKO_TOKEN` from the OS environment.\r
- If `BLINKO_HOST` is missing, defaults to `http://127.0.0.1:1111`.\r
- Uses Blinko API note endpoints (`/v1/note/...`) for both notes and blinkos.\r
- Prints API responses to stdout; errors go to stderr with non-zero exit.\r
Usage Guidance
This skill is a small, self-contained Python CLI that talks to a Blinko HTTP API. It behaves as advertised: you should set BLINKO_HOST and BLINKO_TOKEN in your environment before use. Two practical checks before installing/using: (1) verify the BLINKO_HOST points to a server you control or trust (the script will send requests there), and (2) treat BLINKO_TOKEN like any API secret — don’t expose it in shared shells or logs. Note the registry metadata omitted the env variables used by the script; that mismatch is likely benign but worth being aware of. If you plan to let an agent call this autonomously, ensure the agent is allowed to talk to the configured host and that the token’s privileges are limited.
Capability Analysis
Type: OpenClaw Skill
Name: blinko-api
Version: 1.0.0
The skill bundle is a standard API client for managing notes and 'blinkos' via the Blinko service. The Python script (scripts/blinko_client.py) uses the standard library to perform CRUD operations and correctly handles authentication via environment variables or command-line arguments, with no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (manage notes/blinkos) aligns with the included Python client which calls /v1/note/... endpoints. One minor inconsistency: registry metadata lists no required env vars, but the SKILL.md and the script read BLINKO_HOST and BLINKO_TOKEN (optional defaults applied). This is likely an omission in metadata, not a functional mismatch.
Instruction Scope
SKILL.md instructs the user to set BLINKO_HOST and BLINKO_TOKEN and to run the provided Python script for list/get/upsert/delete/promote operations. The runtime instructions only reference the API host/token and standard CLI use; they do not ask the agent to read arbitrary system files or exfiltrate unrelated data.
Install Mechanism
No install spec; skill is instruction-only plus a small bundled Python script. There are no downloads or install actions that would write or execute remote code.
Credentials
The script uses BLINKO_HOST and BLINKO_TOKEN from the environment (with sensible defaults: localhost and empty token). Because the registry metadata did not declare these as required, users may not be warned about needing an API token. Requiring a token for API access is reasonable, but ensure you only set BLINKO_HOST to servers you trust and keep BLINKO_TOKEN secret.
Persistence & Privilege
The skill is not always-enabled and does not request elevated privileges, persistent installation, or modification of other skills. It runs only when invoked and only performs outbound HTTP requests to the configured host.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install blinko-api - After installation, invoke the skill by name or use
/blinko-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Blinko skill for command-line note management.
- Add commands to list, create, update, delete, and promote blinkos and notes.
- Supports reading configuration from BLINKO_HOST and BLINKO_TOKEN environment variables.
- Provides CLI example usage for all major operations.
- API interactions print results to stdout, with errors to stderr and non-zero exit codes.
- Triggers include phrases like "save to blinko", "blinko markdown", and "get blinko".
Metadata
Frequently Asked Questions
What is Blinko Api?
Manage Blinko notes and blinkos from the command line. Use when you need to list, create, update, delete, or promote blinkos. It is an AI Agent Skill for Claude Code / OpenClaw, with 267 downloads so far.
How do I install Blinko Api?
Run "/install blinko-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Blinko Api free?
Yes, Blinko Api is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Blinko Api support?
Blinko Api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Blinko Api?
It is built and maintained by pigd0g (@pigd0g); the current version is v1.0.0.
More Skills