Commonroom
Apps & AutomationcommonroomCommonroom 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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
| Function | Description |
|---|---|
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
| Route | Description |
|---|---|
GET /api/commonroom/members | Search 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
getMemberByEmailuses POST/members/searchand returns singleCommunityMemberor null on error- API returns
{ items: ... }wrappers or raw arrays — code handles both - Use for finding community engagement signals to enrich customer profiles