Skip to content

Consolidate Partiful skills into one progressive skill - #71

Merged
KalebCole merged 3 commits into
mainfrom
feat/singular-partiful-skill
Jul 30, 2026
Merged

Consolidate Partiful skills into one progressive skill#71
KalebCole merged 3 commits into
mainfrom
feat/singular-partiful-skill

Conversation

@KalebCole

@KalebCole KalebCole commented Jul 28, 2026

Copy link
Copy Markdown
Owner

Closes #70.

What changed

  • Replaced five overlapping partiful-* skills with one model-invokable partiful skill.
  • Moved task-specific guidance into five focused references for progressive disclosure.
  • Removed the obsolete partiful setup openclaw command, registration, tests, and package keyword.
  • Added structural tests for singular-skill packaging, reference routing, documented command paths, and complete OpenClaw removal.
  • Marked the old OpenClaw distribution plan as superseded.

Verification

  • npm test: 210 passed, 6 skipped
  • npm run typecheck: passed
  • npm pack --dry-run: exactly skills/partiful/SKILL.md plus five references
  • Documented helper command paths verified against implementation
  • Independent adversarial review findings fixed before commit

Summary by CodeRabbit

  • New Features

    • Added consolidated Partiful CLI guidance covering authentication, events, guests, posters, images, and text blasts.
    • Added safety, privacy, formatting, and workflow recommendations, including dry-run and approval guidance.
  • Documentation

    • Reorganized skill documentation into a single Partiful skill with task-specific reference pages.
    • Marked the previous distribution plan as superseded.
  • Removed

    • Removed the OpenClaw setup command and legacy standalone skill documentation.

@coderabbitai

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@KalebCole, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 30 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

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.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 2f1ae4a6-5b4e-4118-b63c-15604a7fcdd8

📥 Commits

Reviewing files that changed from the base of the PR and between ef28e5d and d875ebb.

📒 Files selected for processing (7)
  • skills/partiful/SKILL.md
  • skills/partiful/references/authentication.md
  • skills/partiful/references/cli-output-and-safety.md
  • skills/partiful/references/events.md
  • skills/partiful/references/guests-invitations-and-cohosts.md
  • skills/partiful/references/rsvps-and-interest.md
  • tests/skill-structure.test.js
📝 Walkthrough

Walkthrough

The PR consolidates separate Partiful skills into one routed skill with reference documentation, removes the setup openclaw command and related packaging metadata, and adds tests covering skill structure, documentation routing, and obsolete command removal.

Changes

Partiful skill migration

Layer / File(s) Summary
Consolidated skill documentation
skills/partiful/SKILL.md, skills/partiful/references/*, skills/partiful-*/SKILL.md
Adds a singular Partiful skill with progressive reference routing for authentication, events, guests, posters, and text blasts while removing the former standalone skill documentation.
OpenClaw setup removal
src/cli.ts, src/commands/setup.ts, tests/setup.test.js, package.json, docs/plans/...
Removes setup command registration and implementation, deletes its tests, removes the openclaw keyword, and marks the distribution plan as superseded.
Skill distribution validation
tests/skill-structure.test.js
Tests the single shipped skill, reference links and routing, helper command documentation, source-to-document consistency, and failure of setup openclaw.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: consolidating Partiful skills into one progressive skill.
Linked Issues check ✅ Passed The PR implements the singular progressive-disclosure Partiful skill requested in issue #70, with reference docs for the listed tasks.
Out of Scope Changes check ✅ Passed The changes stay within the skill consolidation and OpenClaw removal scope, with no obvious unrelated additions.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/singular-partiful-skill

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 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/partiful/references/auth-output-and-safety.md`:
- Line 37: Fix the `--format` row in the Markdown table by escaping the embedded
pipe characters in the format alternatives, or replace them with wording that
avoids pipes. Preserve the documented JSON default and keep the cell as a single
valid table column.

In `@skills/partiful/references/events.md`:
- Line 27: Update the default timezone statement in the events reference to use
the canonical IANA identifier America/Los_Angeles instead of the ambiguous
“Pacific” wording. Preserve the existing date and description guidance.
- Line 21: Update the event description argument in the command example to use
Bash ANSI-C quoting, ensuring the embedded newline escapes become actual line
breaks rather than literal “\n” text.
🪄 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: fcf41592-aba0-4a1a-9dba-674bbe966e0f

📥 Commits

Reviewing files that changed from the base of the PR and between 34fcde7 and ef28e5d.

📒 Files selected for processing (17)
  • docs/plans/2026-03-26-distribution-plan.md
  • package.json
  • skills/partiful-blasts/SKILL.md
  • skills/partiful-events/SKILL.md
  • skills/partiful-guests/SKILL.md
  • skills/partiful-posters/SKILL.md
  • skills/partiful-shared/SKILL.md
  • skills/partiful/SKILL.md
  • skills/partiful/references/auth-output-and-safety.md
  • skills/partiful/references/events.md
  • skills/partiful/references/guests-and-rsvps.md
  • skills/partiful/references/posters-and-images.md
  • skills/partiful/references/text-blasts.md
  • src/cli.ts
  • src/commands/setup.ts
  • tests/setup.test.js
  • tests/skill-structure.test.js
💤 Files with no reviewable changes (8)
  • skills/partiful-blasts/SKILL.md
  • src/commands/setup.ts
  • skills/partiful-events/SKILL.md
  • skills/partiful-posters/SKILL.md
  • skills/partiful-shared/SKILL.md
  • tests/setup.test.js
  • skills/partiful-guests/SKILL.md
  • src/cli.ts


| Flag | Purpose |
|---|---|
| `--format <json|table|csv|ndjson>` | Output format; JSON is default |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Fix the malformed --format table cell.

Line [37] contains unescaped pipe characters inside a Markdown table cell, causing MD056 and potentially rendering the row as multiple columns. Use wording that avoids embedded pipes or escape them.

Proposed fix
-| `--format <json|table|csv|ndjson>` | Output format; JSON is default |
+| `--format <json, table, csv, or ndjson>` | Output format; JSON is default |
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
| `--format <json|table|csv|ndjson>` | Output format; JSON is default |
| `--format <json, table, csv, or ndjson>` | Output format; JSON is default |
🧰 Tools
🪛 markdownlint-cli2 (0.23.0)

[warning] 37-37: Table column count
Expected: 2; Actual: 5; Too many cells, extra data will be missing

(MD056, table-column-count)

🤖 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 `@skills/partiful/references/auth-output-and-safety.md` at line 37, Fix the
`--format` row in the Markdown table by escaping the embedded pipe characters in
the format alternatives, or replace them with wording that avoids pipes.
Preserve the documented JSON default and keep the cell as a single valid table
column.

Source: Linters/SAST tools

Comment thread skills/partiful/references/events.md Outdated
Comment thread skills/partiful/references/events.md Outdated
@@ -0,0 +1,63 @@
# Auth, Output, and Safety

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

should we move auth to it's own skill ?

partiful events interested <event-id> --remove
```

`explore rsvp` and `explore interested` are equivalent aliases. Ticketed events and host questionnaires cannot be completed through the CLI; use Partiful directly.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

make a pr and verify if host questionnaries can be completed or not

Comment thread skills/partiful/SKILL.md Outdated
@@ -0,0 +1,36 @@
---
name: partiful
description: Use when managing Partiful from the CLI, including authentication, events, RSVPs, guests, invitations, cohosts, contacts, posters, images, templates, exports, bulk operations, and text blasts.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

use when managing any partiful event. use when the user wants to check partiful, see what's events to go to, create events for people,etc. needs another pass on this description to be better

Comment thread skills/partiful/SKILL.md Outdated

| Task | Read |
|---|---|
| Login, auth status, diagnostics, output formats, global flags, schema, errors, security | [Auth, output, and safety](references/auth-output-and-safety.md) |

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

determine if we need to move authentication to its own referece

Comment thread skills/partiful/SKILL.md Outdated
|---|---|
| Login, auth status, diagnostics, output formats, global flags, schema, errors, security | [Auth, output, and safety](references/auth-output-and-safety.md) |
| List, inspect, create, update, cancel, clone, template, or bulk-manage events | [Events](references/events.md) |
| RSVP, express interest, list/export/watch guests, invite people, find contacts, or manage cohosts | [Guests and RSVPs](references/guests-and-rsvps.md) |

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

determine if we seperate this into different markdown files (i think yes)

@KalebCole
KalebCole merged commit 0086e34 into main Jul 30, 2026
1 check passed
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.

[WAYFINDER] Change Agent Skills to progressively disclosed singular skill

1 participant