Skip to content

Add TweetClaw source research skill#1

Open
kriptoburak wants to merge 1 commit into
framerslab:masterfrom
kriptoburak:codex/tweetclaw-source-research
Open

Add TweetClaw source research skill#1
kriptoburak wants to merge 1 commit into
framerslab:masterfrom
kriptoburak:codex/tweetclaw-source-research

Conversation

@kriptoburak
Copy link
Copy Markdown

@kriptoburak kriptoburak commented Jun 7, 2026

Summary

  • Add a community tweetclaw-source-research skill for OpenClaw users who need X/Twitter source context before drafting or social automation.
  • Register the skill in registry.json.
  • Add the missing yaml dependency used by scripts/update-registry.mjs, so the documented registry refresh command can run from a clean install.

Notes

The skill keeps TweetClaw framed as source research and evidence intake. It does not claim AgentOS directly executes TweetClaw unless the workspace has an OpenClaw runtime installed, and it keeps write-like actions inside OpenClaw/TweetClaw approval boundaries.

Validation

  • npm run validate -- registry/community/tweetclaw-source-research/SKILL.md
  • npm install --no-save --package-lock=false --no-audit --no-fund yaml
  • npm run update:registry
  • npm run typecheck
  • npm run build
  • git diff --check
  • Checked https://github.com/Xquik-dev/tweetclaw returned HTTP 200.
  • Checked npm view @xquik/tweetclaw version repository.url homepage --json returned published version 1.6.31 and the canonical GitHub URLs.

npm run validate for the whole repository currently reports pre-existing curated-skill issues unrelated to this PR, such as missing required frontmatter fields and categories that are not in the current validator allowlist. The new tweetclaw-source-research skill itself passes validation.

Summary by Sourcery

Introduce a new TweetClaw-based source research skill and register it in the skills registry while ensuring the registry update tooling has its yaml dependency installed.

New Features:

  • Add a community tweetclaw-source-research skill describing how to use TweetClaw via OpenClaw for X/Twitter source-research workflows.

Build:

  • Add yaml runtime dependency required by the registry update script so it can run on a clean install.

Documentation:

  • Document setup, workflows, safety guidance, and usage examples for the tweetclaw-source-research skill.

Summary by CodeRabbit

  • New Features

    • Added tweetclaw-source-research community skill for gathering X/Twitter source context via the OpenClaw runtime.
  • Documentation

    • Added comprehensive skill documentation including workflow steps, safety rules, and example prompts.
  • Chores

    • Updated registry metadata and statistics.

@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@sourcery-ai
Copy link
Copy Markdown

sourcery-ai Bot commented Jun 7, 2026

Reviewer's Guide

Adds a new community TweetClaw source-research skill, registers it in the global registry, and introduces a yaml dependency required for the registry update script to work from a clean install.

Flow diagram for TweetClaw source research workflow

flowchart TD
  A[Define research question,
accounts, keywords,
window, output format]
  B[Use TweetClaw read-only tools
for search and lookup]
  C[Summarize source context
with URLs, handles, metrics]
  D[Separate facts from
recommendations]
  E[Approval checkpoint for
write-like actions]
  F[Report results and
identifiers]

  A --> B --> C --> D --> E --> F
Loading

File-Level Changes

Change Details Files
Add TweetClaw source research skill documentation and workflow guidance as a new community skill.
  • Define skill frontmatter including metadata, secrets, tools, and tags for tweetclaw-source-research.
  • Document setup steps for installing and inspecting the TweetClaw OpenClaw plugin.
  • Describe recommended workflows, drafting guidance, safety constraints, and usage examples for TweetClaw as a source-research tool.
registry/community/tweetclaw-source-research/SKILL.md
Register the new TweetClaw skill in the registry so it becomes discoverable to AgentOS/OpenClaw.
  • Add a registry entry referencing the tweetclaw-source-research skill under the community namespace.
  • Ensure the registry schema fields (name, version, category, metadata, etc.) are consistent with existing registry entries and validator expectations.
registry.json
Add yaml as a runtime dependency so registry update tooling works on clean installs.
  • Declare yaml ^2.8.2 under the package.json dependencies section.
  • Align dependency usage with scripts/update-registry.mjs so npm run update:registry succeeds without extra manual installs.
package.json

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jun 7, 2026

Review Change Stack

Warning

Review limit reached

@kriptoburak, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 52 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d734bb8c-a970-4882-84a3-ff97633b95ec

📥 Commits

Reviewing files that changed from the base of the PR and between 1f9244a and 78085c1.

📒 Files selected for processing (3)
  • package.json
  • registry.json
  • registry/community/tweetclaw-source-research/SKILL.md
📝 Walkthrough

Walkthrough

This PR introduces a new community skill, tweetclaw-source-research, that enables research workflows for gathering X/Twitter source context. The PR updates the skill registry metadata, adds comprehensive skill documentation with operational guidance, and declares a required YAML package dependency.

Changes

Community Skill Registration

Layer / File(s) Summary
Skill definition and documentation
registry/community/tweetclaw-source-research/SKILL.md
Introduces the tweetclaw-source-research skill (v1.0.0) with frontmatter metadata, required secrets (xquik.apiKey), shell tool dependency, and operational documentation covering read-only research workflows, fact-versus-recommendation separation, approval boundaries for write-like actions, safety rules for untrusted content and credential handling, plus example prompts and runtime constraints.
Registry metadata and registration
registry.json
Registers the new skill in the registry by adding it to categories.community, creating a skills.community entry with metadata, updating the updated timestamp, and incrementing totalSkills (88→89) and communityCount (0→1).
Package dependency addition
package.json
Adds yaml package (^2.8.2) as a runtime dependency.

🎯 2 (Simple) | ⏱️ ~12 minutes

🐰 A new skill hops into the registry today,
For tweeting research in a read-only way,
With yaml as fuel and safe workflows aligned,
The tweetclaw bounds facts from thoughts of the mind.

🚥 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 a new TweetClaw source research skill to the repository.
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

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

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've left some high level feedback:

  • Consider moving the yaml package from dependencies to devDependencies (or using an inline script-friendly approach) since it appears to be used only by scripts/update-registry.mjs, to avoid imposing this runtime dependency on consumers of the content-only package.
  • In SKILL.md, you may want to briefly clarify the relationship between requires_secrets: [xquik.apiKey] and the XQUIK_API_KEY environment variable in the metadata.agentos.primaryEnv field, so it’s obvious how the secret is expected to be wired into the runtime.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- Consider moving the `yaml` package from `dependencies` to `devDependencies` (or using an inline script-friendly approach) since it appears to be used only by `scripts/update-registry.mjs`, to avoid imposing this runtime dependency on consumers of the content-only package.
- In `SKILL.md`, you may want to briefly clarify the relationship between `requires_secrets: [xquik.apiKey]` and the `XQUIK_API_KEY` environment variable in the `metadata.agentos.primaryEnv` field, so it’s obvious how the secret is expected to be wired into the runtime.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
registry/community/tweetclaw-source-research/SKILL.md (1)

13-13: 💤 Low value

Consider using an actual emoji character instead of the letter "X".

The emoji field is set to the letter "X" rather than a Unicode emoji. Other skills in the registry use actual emoji characters (e.g., 🔐, 🔊, 💻). While the letter may be intentional for the X/Twitter platform, it may render as plain text in UIs that expect a visual emoji icon.

♻️ Suggested emoji alternatives
-    emoji: "X"
+    emoji: "𝕏"

or

-    emoji: "X"
+    emoji: "🐦"
🤖 Prompt for 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.

In `@registry/community/tweetclaw-source-research/SKILL.md` at line 13, Replace
the emoji field value in SKILL.md (the emoji: "X" entry) with a real Unicode
emoji character so UIs render an icon instead of a plain letter; pick an emoji
that fits the skill (e.g., a bird like 🐦, a cross like ❌/✖️, or another
relevant glyph) and update the emoji field to that character.
🤖 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 `@package.json`:
- Around line 35-37: The yaml dependency in package.json is pinned as "yaml":
"^2.8.2" which can resolve to the vulnerable 2.8.2; update the version range to
at least "^2.8.3" (or a newer safe release) in package.json (the "yaml" entry)
and then regenerate your lockfile (npm/yarn/pnpm install) so the resolved
dependency is updated; run tests/build to confirm nothing breaks after the bump.

In `@registry/community/tweetclaw-source-research/SKILL.md`:
- Line 10: The SKILL definition uses an invalid tool id `requires_tools:
[shell]`; update the SKILL.md entry to reference the correct tool identifier
used in this repo (e.g., change `requires_tools: [shell]` to `requires_tools:
[shell_execute]`) or add a short note in the SKILL.md documenting `shell` as a
supported alias mapped to `shell_execute`; locate and update the
`requires_tools` line in the SKILL.md for the tweetclaw-source-research skill
(the `requires_tools` field) so it matches the registry tool id
(`shell_execute`) used elsewhere.

---

Nitpick comments:
In `@registry/community/tweetclaw-source-research/SKILL.md`:
- Line 13: Replace the emoji field value in SKILL.md (the emoji: "X" entry) with
a real Unicode emoji character so UIs render an icon instead of a plain letter;
pick an emoji that fits the skill (e.g., a bird like 🐦, a cross like ❌/✖️, or
another relevant glyph) and update the emoji field to that character.
🪄 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: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: da168fda-17e4-4f35-9b0e-4f997313627b

📥 Commits

Reviewing files that changed from the base of the PR and between 5c6a6d1 and 1f9244a.

📒 Files selected for processing (3)
  • package.json
  • registry.json
  • registry/community/tweetclaw-source-research/SKILL.md

Comment thread package.json Outdated
Comment thread registry/community/tweetclaw-source-research/SKILL.md Outdated
@kriptoburak kriptoburak force-pushed the codex/tweetclaw-source-research branch from 1f9244a to 78085c1 Compare June 7, 2026 17:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant