PostLocker skill

This is the PostLocker skill for AI agents and humans: it teaches how to use PostLocker via the postlocker CLI — save content (links, places, contacts, notes), search semantically, organize with groups and tags, export/import, and pipe commands for bulk operations. The skill is AgentSkills-compatible (e.g. OpenClaw).

Install the CLI from PyPI

Before using this skill, install the PostLocker CLI so the postlocker command is available:

pip install postlocker[cli]

• Use the same Python environment that your agent uses.
• Verify: run postlocker --help. If the command is not found, add the Python Scripts (Windows) or bin (Unix) directory to PATH, or set POSTLOCKER_BIN to the full path of the postlocker executable.
• Auth: On first use the CLI will prompt for email/password and store a token under ~/.postlocker/tokens.json.

What’s in this folder

Path	Purpose
SKILL.md	Main skill doc for agents: what PostLocker is, use cases (research, organizing places/contacts/links, grouping), CLI usage, piping, organizing workflow.
references/cli.md	CLI command reference.
scripts/	Helpers: postlocker_run.py (UTF-8 + POSTLOCKER_BIN shim), postlocker_api.py (run/parse helpers), examples_smoke.ps1 (smoke commands).

Install and use with OpenClaw

1. Make the skill available to OpenClaw
   In ~/.openclaw/openclaw.json, add this folder (the one that contains SKILL.md) to skills.load.extraDirs. Use the absolute path to the PostLockerSkill folder:

   {
     "skills": {
       "load": {
         "extraDirs": ["E:/work/Sineways/PostLockerCLI/PostLockerSkill"]
       }
     }
   }

   Replace with your actual path. OpenClaw will discover the skill from the SKILL.md in this folder.

2. Install the CLI (on the machine where OpenClaw runs):

   pip install postlocker[cli]
   postlocker --help

3. Log in once (any command will prompt for email/password if no token):

   postlocker list --limit 1

4. Use the skill in OpenClaw
   Ask the agent for PostLocker tasks, e.g.:

   • “What have I saved about Unity?”
   • “Create a group for Paris trip and add all Paris-related saves.”
   • “List my saves from the last week.”
   • “Export everything tagged ‘research’ to a JSON file.”

   The agent uses SKILL.md and references/cli.md in this folder to choose the right commands.

Quick commands

Goal	Command
Save a link with note and tags	postlocker save "https://..." --note "Read later" -T reading
Search by meaning	postlocker search "tutorials about game engines"
List recent saves	postlocker list --limit 20
Create a group and add saves	postlocker groups create then postlocker groups get "<ID>" id1 id2 --add
Pipe search into group	postlocker search "Unity" --pipe | postlocker groups get "<GROUP_ID>" --add
Export search results	postlocker search "important" --pipe | postlocker export -o important.json

Full use-case examples and the full command reference are in SKILL.md and references/cli.md in this folder.