OpenParable
Skip to content
← Back to skills

Commonroom

Apps & Automation
commonroom

Commonroom is an Agent Skill for apps & automation published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Look up community member engagement and signals via Common Room. Use this skill when the user asks about community activity, member engagement, or community signals.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/templates/analytics/.builder/skills/commonroom/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/commonroom, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Common Room Integration (Community)

Connection

  • Base URL: https://api.commonroom.io/community/v1
  • Auth: Authorization: Bearer $COMMONROOM_API_TOKEN
  • Env vars: COMMONROOM_API_TOKEN
  • Caching: 10-minute in-memory cache, max 120 entries

Server Lib & API Routes

  • File: server/lib/commonroom.ts

Exported Functions

FunctionDescription
getTokenStatus()Check API token validity
getMemberByEmail(email)Look up a member by email (returns null on failure)
getMembers(params?)Search members (POST with query, cursor, limit)
getActivityForMember(memberId)Get activity feed for a member
getSegments()List community segments

API Routes

RouteDescription
GET /api/commonroom/membersSearch community members

Script Usage

# Search by email
pnpm action commonroom-members [email protected]

# Search by query
pnpm action commonroom-members --query=search_term

# List segments
pnpm action commonroom-members --segments

Key Patterns & Gotchas

  • getMemberByEmail uses POST /members/search and returns single CommunityMember or null on error
  • API returns { items: ... } wrappers or raw arrays — code handles both
  • Use for finding community engagement signals to enrich customer profiles