Skip to content

feat(#30): Update OpenClaw skills with formatting rules + poster/image docs#42

Merged
KalebCole merged 3 commits intomainfrom
sasha/skill-update-30
Mar 25, 2026
Merged

feat(#30): Update OpenClaw skills with formatting rules + poster/image docs#42
KalebCole merged 3 commits intomainfrom
sasha/skill-update-30

Conversation

@KalebCole
Copy link
Copy Markdown
Owner

@KalebCole KalebCole commented Mar 25, 2026

Closes #30

What

Updates all OpenClaw skills to the CLI-first pattern (replacing old browser-automation skill) and adds the formatting/date guidelines from #30.

Changes

partiful-events/SKILL.md

  • Added all poster/image flags (--poster, --poster-search, --image)
  • Added formatting rules: plain text only (no markdown), full year dates, AM/PM verification
  • Documented all create/update flags in a table
  • Added posters & images section with examples

partiful-shared/SKILL.md

  • Added formatting rules section (dates, descriptions, times)
  • Added schema introspection docs
  • Cleaned up auth docs

partiful-posters/SKILL.md (new)

  • Browse/search/get poster catalog
  • Usage examples with events create

OpenClaw Integration

Old skills/partiful/ (single browser-automation skill) replaced by 5 skills following the gws naming convention:

  • partiful-shared — auth, flags, formatting rules
  • partiful-events — CRUD + posters/images
  • partiful-guests — RSVPs, invites, watch, export
  • partiful-blasts — text blasts
  • partiful-posters — poster catalog

Summary by CodeRabbit

  • Documentation
    • Events docs: streamlined listing flags, changed event-detail output to table, expanded create/update guidance with poster/image options, clarified clone/share wording, added Posters & Images and Formatting Rules, and clarified dry-run preview behavior
    • Posters docs: added new public poster catalog docs with list/search/get workflows and examples for using posters during event flows
    • Shared docs: tightened login/auth wording and phone formatting, refined global flag descriptions, added formatting rules and schema discovery commands

… docs

- partiful-events: added poster/image flags, formatting rules (plain text, full year dates, AM/PM check)
- partiful-shared: added formatting rules, schema introspection docs
- partiful-posters: new skill for poster catalog browsing
- Replaces old browser-automation-only skill with CLI-first pattern
- Follows gws naming convention: partiful-{resource}

Closes #30
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 25, 2026

Warning

Rate limit exceeded

@KalebCole has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 6 minutes and 19 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, 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 have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f9d70437-2f05-411c-b59c-94451417abd4

📥 Commits

Reviewing files that changed from the base of the PR and between 4c03d5d and c59c5cc.

📒 Files selected for processing (1)
  • skills/partiful-shared/SKILL.md
📝 Walkthrough

Walkthrough

Updated Partiful CLI documentation across three SKILL.md files: replaced event-list flags with --past/--include-cancelled, switched event-detail default --format to table, added poster/image flags and workflows, introduced a new posters skill doc, and added formatting rules for dates, descriptions, and timezone guidance.

Changes

Cohort / File(s) Summary
Partiful Events Skill
skills/partiful-events/SKILL.md
Reworked event-list filtering flags (--past, --include-cancelled), changed examples to --format table, expanded events create and events update flags (added --poster, --poster-search, --image, imagery notes), added "Posters & Images" and "Formatting Rules" sections, and clarified --dry-run wording.
Partiful Posters Skill
skills/partiful-posters/SKILL.md
New documentation for the public poster catalog: partiful posters list, search, and get commands with examples; documents poster IDs and --poster / --poster-search usage for events.
Partiful Shared Skill
skills/partiful-shared/SKILL.md
Updated auth/login example and E.164 guidance, adjusted --no-auto description, refined global flags (--dry-run, --verbose), and added "Formatting Rules (Important!)" (full-year dates, default timezone and --timezone, plain-text-only descriptions, AM/PM checks) plus "Schema Introspection" notes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐰 I hopped through docs with gentle paws,
Dates with years and plain-text laws,
Posters found and images set,
No markdown trouble—no regret.
Dry-runs preview, tips in tow, hooray! 🥕

🚥 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 'feat(#30): Update OpenClaw skills with formatting rules + poster/image docs' accurately summarizes the main changes: updating skills documentation with formatting rules and poster/image documentation.
Linked Issues check ✅ Passed The PR fulfills all acceptance criteria from issue #30: SKILL.md files document formatting guidelines (plain text, no markdown), date format requirements (full-year dates like 2026-03-15), timezone handling (default America/Los_Angeles explicitly stated), and examples demonstrate correct patterns throughout.
Out of Scope Changes check ✅ Passed All changes are directly scoped to the linked issue #30: documentation updates for formatting rules, date guidelines, and newly added poster/image documentation. No unrelated code changes or features outside the specified objectives are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch sasha/skill-update-30

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

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: 4

🧹 Nitpick comments (1)
skills/partiful-posters/SKILL.md (1)

40-48: Clarify auth boundary for events create examples.

Line 8 says “No auth required,” which is true for poster catalog commands, but Lines 42 and 47 invoke events create (which still requires Partiful auth). Add one explicit note here to avoid operator confusion.

Suggested doc tweak
 ## Usage with Events

 Once you find a poster ID, pass it to `events create` or `events update`:
+> Note: Poster catalog commands are public, but `events create` / `events update` still require Partiful authentication.
 ```bash
 partiful events create --title "Party" --date "2026-04-05T19:00" --poster "piscesairbrush.png"
</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against the current code and only fix it if needed.

In @skills/partiful-posters/SKILL.md around lines 40 - 48, The examples for
passing a poster ID to events create and using --poster-search are unclear about
authentication: clarify that the "No auth required" note applies only to the
poster catalog commands and not to events create/update; update the text around
the events create examples (references: the events create command and the
--poster-search flag) to add a short explicit note like "events create/update
require Partiful authentication" so operators know they must be authenticated
before running those commands.


</details>

</blockquote></details>

</blockquote></details>

<details>
<summary>🤖 Prompt for all review comments with AI agents</summary>

Verify each finding against the current code and only fix it if needed.

Inline comments:
In @skills/partiful-events/SKILL.md:

  • Around line 103-116: The fenced code blocks showing the date/time examples and
    the description examples in SKILL.md are missing explicit fence languages;
    update the backtick fences for both examples (the block with "✅ 2026-04-01T19:00
    ..." and the block with the description examples containing "🎮 Game Night!" and
    "Game Night!") to include a language such as text (e.g., ```text) so
    markdownlint rule MD040 is satisfied.
  • Around line 95-98: The docs list an unavailable command; remove or relocate
    the "Share Link (+share)" entry from SKILL.md so it matches the implemented
    commands in registerEventsCommands (which only exposes
    list/get/create/update/cancel), or if +share exists elsewhere, move the snippet
    to the correct skill/command doc; update the README so the documented commands
    exactly match the registerEventsCommands API.
  • Around line 65-70: Update the auth table in SKILL.md to correctly state that
    poster flags used by the event commands require Partiful authentication: change
    the "No" entries for --poster <id> and --poster-search <query> to indicate
    Partiful auth required (or rephrase the table header to "Partiful auth required
    for event mutations"), and clarify that --image <path|url> requires both
    Partiful auth for event create/update and an additional Firebase token for
    custom uploads; ensure the Notes column mentions the 10MB limit remains.

In @skills/partiful-shared/SKILL.md:

  • Around line 73-86: Update the two fenced code blocks that show the date
    examples and the "Descriptions — Plain Text Only" examples by adding the
    language identifier "text" to the opening fences (change totext) so they
    satisfy MD040; target the fenced block containing the date lines (the ✅/❌
    examples) and the fenced block containing the plain-text description examples
    (the quoted game night lines).

Nitpick comments:
In @skills/partiful-posters/SKILL.md:

  • Around line 40-48: The examples for passing a poster ID to events create and
    using --poster-search are unclear about authentication: clarify that the "No
    auth required" note applies only to the poster catalog commands and not to
    events create/update; update the text around the events create examples
    (references: the events create command and the --poster-search flag) to add a
    short explicit note like "events create/update require Partiful authentication"
    so operators know they must be authenticated before running those commands.

</details>

---

<details>
<summary>ℹ️ Review info</summary>

<details>
<summary>⚙️ Run configuration</summary>

**Configuration used**: defaults

**Review profile**: CHILL

**Plan**: Pro

**Run ID**: `d26f8d94-e0e3-4908-9cc4-7a8d3d998e04`

</details>

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 899898cc3af30086e28ddd6ca0858db2541d7ff2 and 495de7cfc0b0ad73d84fe0084d2f75596854c87b.

</details>

<details>
<summary>📒 Files selected for processing (3)</summary>

* `skills/partiful-events/SKILL.md`
* `skills/partiful-posters/SKILL.md`
* `skills/partiful-shared/SKILL.md`

</details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

- Auth table: clarified that all event mutations need Partiful auth, custom upload additionally needs Firebase token
- Removed undocumented events +share helper (not implemented)
- Added 'text' language identifier to all formatting example code blocks (MD040)
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

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@skills/partiful-shared/SKILL.md`:
- Line 15: Update the SKILL.md wording "Phone-based authentication in **E.164
format**." to reflect actual behavior: indicate that E.164 is supported but
non-`+` US numbers will be normalized by prepending `+1` (e.g., "E.164 (US
numbers without a leading '+' will be normalized with +1)"), so users aren’t
misled about accepted input; ensure the sentence referencing phone auth clearly
mentions the automatic +1 normalization used by the login command.
- Around line 18-19: The wording in SKILL.md that reads "Auto-retrieves the code
from iMessage (via `imsg`)" incorrectly implies macOS-only support; update that
phrase to mention SMS auto-retrieval across platforms by replacing it with
something like "Auto-retrieves the code from SMS sources (e.g., iMessage via
`imsg` on macOS or Termux SMS on Android)" so both iMessage and Termux are
clearly represented; locate the exact text "Auto-retrieves the code from
iMessage (via `imsg`)" and replace it with a broader platform-agnostic
description that references `imsg` and Termux where appropriate.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 74e8d98c-1e21-4b95-91c5-7bdaf35a8208

📥 Commits

Reviewing files that changed from the base of the PR and between 495de7c and 4c03d5d.

📒 Files selected for processing (2)
  • skills/partiful-events/SKILL.md
  • skills/partiful-shared/SKILL.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • skills/partiful-events/SKILL.md

- E.164 format is preferred but US numbers without +1 are auto-normalized
- SMS auto-retrieval supports macOS (imsg) and Android (termux-sms-list), not just macOS
@KalebCole KalebCole merged commit 64d832a into main Mar 25, 2026
1 check passed
@KalebCole KalebCole deleted the sasha/skill-update-30 branch March 25, 2026 04:46
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.

[P2] Update OpenClaw skill with formatting and date guidelines

1 participant