docs: add TweetClaw OpenClaw X API guidance

[kriptoburak]

Summary

• add optional TweetClaw/OpenClaw tooling guidance to the X API skill
• keep raw X API code as the default path while routing agent-managed workflows through an approval-gated tool
• normalize existing dash punctuation in the touched skill file

Validation

• markdown-link-check on skills/x-api/SKILL.md
• git diff check
• npm test

Note: npm ci reported one existing moderate dependency advisory in the target dependency tree before tests. This PR does not change dependencies.

---

Summary by cubic

Adds optional OpenClaw/TweetClaw guidance to the X API skill while keeping direct X API calls as the default path. Documents approval-gated agent workflows and reinforces secret handling.

• New Features

  • Explain when to use OpenClaw/TweetClaw for agent-managed tasks (scraping, search, DMs, media, monitors, webhooks, giveaways, approval-gated posting).
  • Add install command for the plugin: openclaw plugins install npm:@xquik/tweetclaw@1.6.31

• Refactors

  • Normalize dash punctuation in the skill doc for consistency.

^{Written for commit 0a6e4b4. Summary will update on new commits.}

Summary by CodeRabbit

• Documentation
  • Updated X API skill documentation with revised environment configuration guidance.
  • Expanded security guidance section with additional best practices and recommendations.
  • Added new section describing optional tooling for enhanced workflow capabilities, including setup and approval guidance.
  • Updated Related Skills list with improved formatting and comprehensive coverage.

[coderabbitai]

Walkthrough

Documentation updates to the X API skill guide refine OAuth environment setup comment phrasing, expand the Security section with additional OAuth secret handling guidance and new OpenClaw Tooling instructions for TweetClaw integration, and adjust Related Skills formatting to include crosspost.

Changes

X API Skill Documentation

Layer / File(s)	Summary
OAuth comment and Related Skills list skills/x-api/SKILL.md	OAuth environment setup comment phrasing is corrected from an em-dash to a hyphen format. Related Skills bullet list is updated to include crosspost alongside content-engine with consistent formatting.
Security guidance and OpenClaw tooling skills/x-api/SKILL.md	Security section is expanded with an OAuth secret handling bullet. New "Optional OpenClaw Tooling" section documents TweetClaw installation, constraints for keeping secrets out of prompts/logs, and requirement for explicit approval before actions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Suggested labels

skills

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding TweetClaw OpenClaw tooling guidance to X API documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/x-api/SKILL.md`:
- Around line 201-218: Update the TweetClaw install guidance in the Optional
OpenClaw Tooling section: change the pinned package version from
`@xquik/tweetclaw`@1.6.31 to `@xquik/tweetclaw`@1.6.32 and use the canonical install
syntax (e.g., openclaw plugins install npm:`@xquik/tweetclaw`@1.6.32, optionally
noting the --pin flag). Leave the approval-for-write-actions guidance and the
listed supported workflows (tweet scraping/search, follower export, user lookup,
media workflows, DMs, monitors, webhooks, giveaway draws) as-is to reflect
TweetClaw’s documented capabilities.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: cc16b5f5-3511-490f-964b-93e52bfce52c

📥 Commits

Reviewing files that changed from the base of the PR and between f8a6a26 and 0a6e4b4.

📒 Files selected for processing (1)

• skills/x-api/SKILL.md

[cubic-dev-ai]

No issues found across 1 file

_{Re-trigger cubic}