← Back to Skills Marketplace
jujian-pp

PagePop

by jujian-pp · GitHub ↗ · v0.0.4 · MIT-0
cross-platform ✓ Security Clean
26
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install pagepop-skill
Description
Create and continue PagePop content-generation conversations from a host app. Use when the user wants PagePop to generate, refine, or retrieve content artifa...
README (SKILL.md)

PagePop Skill

This skill connects a host application to PagePop.

On first use, the user opens a PagePop authorization page in a browser and confirms access. After authorization, the skill stores a local access key and reuses it for later requests.

Capabilities

  • Start a PagePop generation request.
  • Continue the current PagePop conversation by default.
  • Start a new conversation when explicitly requested.
  • List locally saved conversations for switch-chat flows.
  • Stream PagePop progress and artifact events.
  • Emit a generic artifact delivery view plus channel-aware presentation payloads for host applications.
  • Check whether the installed package should be updated.

Commands

python3 scripts/pagepop_skill.py status
python3 scripts/pagepop_skill.py auth
python3 scripts/pagepop_skill.py conversations
python3 scripts/pagepop_skill.py stream --goal "Create a product launch deck"
python3 scripts/pagepop_skill.py stream --new-chat --goal "Create a rednote post about camping gear"
python3 scripts/pagepop_skill.py resume-stream --conversation-id conv_xxx --offset 0

stream --goal always submits a chat request before reading SSE events. Use resume-stream when the host only needs to replay or continue reading events for an existing conversation without creating a new task. When --offset is omitted, resume-stream uses the saved SSE cursor for that conversation.

Configuration

Production packages are built with a generated skill-manifest.json.

Common environment variables:

  • PAGEPOP_API_BASE_URL
  • PAGEPOP_WEB_BASE_URL
  • PAGEPOP_SKILL_ID
  • PAGEPOP_SKILL_STATE_DIR
  • PAGEPOP_SKILL_REGION
  • PAGEPOP_SKILL_SOURCE_APP
  • PAGEPOP_SKILL_DISPLAY_APP_NAME
  • PAGEPOP_SKILL_RETURN_MODE
  • PAGEPOP_SKILL_RETURN_TARGET
  • PAGEPOP_SKILL_UPDATE_CHANNEL
  • PAGEPOP_SKILL_WAIT_FOR_AUTHORIZATION
  • PAGEPOP_SKILL_ARTIFACT_DIR
  • PAGEPOP_SKILL_DOWNLOAD_IMAGES

The legacy PAGEPOP_OPENCLAW_* names are still accepted as compatibility aliases for existing OpenClaw installations. New integrations should use the PAGEPOP_SKILL_* names. Host-specific usage notes belong in adapters/.

Before invoking this skill, host applications should determine whether the current user is in mainland China or outside mainland China. If PAGEPOP_API_BASE_URL is not set, production domain selection is region-based: mainland China (PAGEPOP_SKILL_REGION=CN or an Asia/Shanghai-style mainland timezone) uses https://pc-api.pagepop.cn; non-mainland users use https://pc-api.pagepop.ai. Missing region data defaults to the global .ai domain and emits an integration_warning.

Host Integration

When a host invokes this skill on behalf of another app, it should pass launch context before authorization:

  • source_app
  • display_app_name
  • return_mode
  • return_target
  • region or PAGEPOP_SKILL_REGION, after deciding mainland China vs non-mainland

If no launch context is provided, the authorization page falls back to the default host label.

Artifact delivery events include:

  • presentation: channel-neutral content for fallback renderers.
  • channel_presentations.slack: Slack Block Kit blocks.
  • channel_presentations.feishu: Feishu interactive-card payload plus media upload hints.
  • target.preferred_channel: normalized from source_app when the host passes launch context.

Hosts should prefer their matching channel_presentations entry, then fall back to presentation.fallback_text. Feishu hosts should avoid rendering raw URLs from generic presentation; use the Feishu card buttons or Feishu-specific fallback text so underscores in URLs are not truncated by lark_md auto-linking. When composing a Feishu chat message manually, send channel_presentations.feishu.media.local_image_messages as image messages first, then send channel_presentations.feishu.plain_text or artifact.display_text; do not copy raw image URLs from artifact.text or sse_event.data into lark_md.

Output

The skill emits JSON Lines. Important event kinds include:

  • auth_required
  • auth_authorized
  • chat_context
  • conversation_history
  • chat_submitted
  • stream_resumed
  • progress_update
  • artifact_update
  • artifact_ready
  • artifact_delivery
  • sse_event
  • stream_finished
  • skill_update_available
  • skill_update_required
  • error
Usage Guidance
This skill looks purpose-aligned for PagePop content generation. Before installing, be comfortable with authorizing PagePop once, storing a local access key, sending prompts and links to PagePop, and reusing saved conversation context by default. Use new-chat for unrelated work and verify any update downloads before installing them.
Capability Assessment
Purpose & Capability
The stated purpose is consistent with the documented behavior: it authorizes PagePop, submits content-generation goals, streams results, and returns artifacts. The main user-visible note is that prompts, links, and generated-content conversations are sent to PagePop's API.
Instruction Scope
Instructions are mostly bounded to PagePop operations. The skill defaults to continuing the active PagePop conversation unless a new chat is requested, which is disclosed but worth noticing because prior context may be reused.
Install Mechanism
There is no install spec, and the documented commands run the included Python script directly. The update mechanism is described as notification-only, with download and installation left to the user or host.
Credentials
Environment variables can select PagePop regions, override API/web base URLs, set state/artifact directories, and enable image downloads. These settings are purpose-aligned, but users and hosts should ensure they point to trusted PagePop endpoints.
Persistence & Privilege
The skill persists a PagePop access key, active conversation ID, saved conversations, and stream cursors locally. This is disclosed and aligned with continuing PagePop conversations, but it is sensitive state.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install pagepop-skill
  3. After installation, invoke the skill by name or use /pagepop-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.4
Version 0.0.4 of pagepop-skill - No code or documentation changes detected in this release. - Behavior and capabilities remain the same as the previous version.
v0.0.5
Version 0.0.5 of pagepop-skill - No file changes detected in this release. - Documentation, features, and configuration remain unchanged from the previous version.
vv0.0.4
- Improved conversation management: easily start, continue, or list PagePop content-generation conversations. - Now streams artifact generation progress and delivery events, with channel-aware payloads for host applications. - Enhanced configuration: supports new PAGEPOP_SKILL_* env vars, with compatibility for legacy PAGEPOP_OPENCLAW_* settings. - Automatic region detection for proper API endpoint selection based on user location. - Host integrations improved with more precise launch context and output formatting, especially for Feishu and Slack. - Expanded command-line interface for checking status, authorizing, and managing conversations.
Metadata
Slug pagepop-skill
Version 0.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is PagePop?

Create and continue PagePop content-generation conversations from a host app. Use when the user wants PagePop to generate, refine, or retrieve content artifa... It is an AI Agent Skill for Claude Code / OpenClaw, with 26 downloads so far.

How do I install PagePop?

Run "/install pagepop-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is PagePop free?

Yes, PagePop is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does PagePop support?

PagePop is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created PagePop?

It is built and maintained by jujian-pp (@jujian-pp); the current version is v0.0.4.

💬 Comments