docs(twitter-influencer-skill): add public source packets

[kriptoburak]

Summary

• Add a public X/Twitter source-packet fallback for drafting when API credentials are not available
• Document TweetClaw OpenClaw exports as one optional source of public examples
• Keep source packets limited to drafting evidence, with no account actions or private content
• Repair two stale API base links in the touched reference doc

Validation

• git diff --check
• npx --yes markdown-link-check README.md .cursor/skills/twitter-influencer-skill/SKILL.md .cursor/skills/twitter-influencer-skill/examples.md .cursor/skills/twitter-influencer-skill/references/api-usage.md .cursor/skills/twitter-influencer-skill/references/public-source-packets.md --quiet
• Direct link checks for TweetClaw, npm registry metadata, ClawHub, and this repository

Summary by CodeRabbit

• Documentation
  • Added comprehensive guide for public source packets feature in Twitter influencer skill
  • Users can now provide public social media data to inform content style, topics, and timing
  • Updated skill references with examples and safety guidelines for public source packet usage
  • Documented fallback workflow when API credentials unavailable

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 6b29b65b-eba7-4d57-9f98-5a5d2fc11ad0

📥 Commits

Reviewing files that changed from the base of the PR and between cb98b25 and c9875dc.

📒 Files selected for processing (5)

• .cursor/skills/twitter-influencer-skill/SKILL.md
• .cursor/skills/twitter-influencer-skill/examples.md
• .cursor/skills/twitter-influencer-skill/references/api-usage.md
• .cursor/skills/twitter-influencer-skill/references/public-source-packets.md
• README.md

---

📝 Walkthrough

Walkthrough

This PR introduces public source packets as a documentation-driven fallback for the Twitter influencer skill when API credentials cannot be provided. A new reference document defines the packet format, required fields, and explicit safety constraints. The main skill documentation, API reference, and user examples are updated cohesively to integrate the feature across workflow, validation, and user-facing guidance.

Changes

Public Source Packet Feature

Layer / File(s)	Summary
Public source packet specification references/public-source-packets.md	New reference document defining accepted input sources, required provenance fields, step-by-step drafting guidance, and explicit prohibitions on private content, credentials, and account action authorization.
Skill workflow and validation constraints SKILL.md	Style source guidance directs users to read the public-source-packets reference; workflow step 2 is updated to handle packets when API access unavailable; new validation section with provenance checklist and constraints on what packets do and do not authorize; reference link added.
API reference and fallback documentation references/api-usage.md	X/Twitter API base URL reformatted with inline backticks; Grok API documentation reference clarified; new public-source fallback section explains what to request when credentials unavailable, where to find the specification, and limitations on packet usage.
User examples and feature introduction examples.md, README.md	New Example 3 demonstrates public source packet input format and drafting workflow; README adds feature note describing optional public-source packet fallback and includes a new Cursor prompt for using packets to draft hooks.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A packet of tweets, public and clean,
No secrets inside, just style to be seen—
When APIs are sleeping, the drafts still take flight,
Through evidence gathered, the hooks shine so bright! 🐦✨

🚥 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 and concisely summarizes the main change: adding public source packets documentation to the Twitter influencer skill.
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.}