From 5fb2ed9464ecfa8a4cb081c8455e4158beacc33f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Burak=20Bay=C4=B1r?= <burakbayir1@gmail.com>
Date: Mon, 25 May 2026 05:22:31 +0300
Subject: [PATCH] docs: document TweetClaw skill install example

Adds usage documentation for installing TweetClaw as an external skill via 'claw skills install', including example workflow for X/Twitter automation.
---
 USAGE.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/USAGE.md b/USAGE.md
index f4958076..cc15da2a 100644
--- a/USAGE.md
+++ b/USAGE.md
@@ -474,6 +474,27 @@ cd rust
 ./target/debug/claw system-prompt --cwd .. --date 2026-04-04
 ```
 
+## Install an external skill
+
+`claw skills install <path>` accepts a local skill directory that contains
+`SKILL.md` or a standalone markdown file. This is useful when a companion
+repository ships a skill prompt that should be available through `/skills`.
+
+For example, install TweetClaw as an X/Twitter automation skill:
+
+```bash
+# From a parent directory that contains claw-code
+git clone https://github.com/Xquik-dev/tweetclaw
+cd claw-code/rust
+./target/debug/claw skills install ../../tweetclaw/skills/tweetclaw
+./target/debug/claw skills show tweetclaw
+```
+
+TweetClaw gives `claw` users a local skill guide for OpenClaw/Xquik workflows
+such as tweet search, reply search, follower export, monitors, webhooks, and
+approval-gated posting. Configure any Xquik credentials outside the prompt and
+avoid pasting API keys into chat.
+
 ## Session management
 
 REPL turns are persisted under `.claw/sessions/` in the current workspace.