contact-face

Debug, modify, or extend the Contact cube face in the home UI.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/peTMat-dev/private-chatting-app --skill contact-face
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contact-face
Source: https://github.com/peTMat-dev/private-chatting-app/tree/main/.claude/skills/contact-face
Command: npx skills add https://github.com/peTMat-dev/private-chatting-app --skill contact-face

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug, modify, or extend the Contact cube face — the left face of the 3D cube UI in home/page.tsx. Use when asked to fix contact add/remove bugs, add new contact sections, update contact API routes, or change contact UI/UX.

Core Features & Use Cases

  • File Map: UI state and handlers live in client/src/app/home/page.tsx; API helpers are in client/src/lib/api.ts; i18n strings are in client/src/lib/i18n.ts; server routes live in server/src/routes/contacts.ts; DB query helper is server/src/services/db.ts; and a DB schema reference is available at client/create_cubcha_v1.sql.
  • State, Types, and Schema: State variables, TS types, DB schema, i18n keys, and CSS classes are documented in state-reference.md.
  • API & Procedures: Server endpoints for contacts (get/add/remove/request) and related stored procedures are described in the skill content; the privacy rules prevent exposing private user existence.
  • Features Not Yet Implemented: Chat from contact list, contact requests, block/unblock, and pending/approved/rejected UI states are NYI.
  • Common Mistakes: A reference to avoid optimistic UI, proper SP unwraps, and proper i18n coverage across languages.

Quick Start

Start by inspecting the Contact Face UI in client/src/app/home/page.tsx and reproduce the issue to begin debugging.

Frequently Asked Questions about contact-face

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix bugs in the Contact face UI of a Next.js 3D cube application?

To fix Contact face UI bugs, inspect the UI state and handlers in client/src/app/home/page.tsx, then reproduce the issue to begin debugging the TypeScript state references and CSS classes. API helpers are in client/src/lib/api.ts.

What's the best way to add new contact sections to a 3D cube UI without breaking i18n?

Adding contact sections requires updating i18n strings in client/src/lib/i18n.ts across all languages and adding corresponding TypeScript types. The skill documentation provides state references and warns against incomplete i18n coverage as a common mistake.

Does the Contact face API support contact requests and blocking features?

The Contact face API does not support contact requests, block/unblock, or pending/approved/rejected UI states yet. These features are marked as NYI (Not Yet Implemented) in the skill documentation.

Why does my contact list API route expose private user existence in a REST API?

Privacy rules in the contact API routes prevent exposing private user existence. Server routes in server/src/routes/contacts.ts implement get/add/remove/request endpoints with stored procedures that enforce these privacy constraints.

How do I properly unwrap stored procedure results for contact database queries?

Proper stored procedure unwrapping is required when using the DB query helper in server/src/services/db.ts. The skill documentation lists avoiding improper SP unwraps as a common mistake, referencing the schema in client/create_cubcha_v1.sql.

Can I use optimistic UI updates when modifying the Contact cube face in a private chatting app?

Optimistic UI updates should be avoided when modifying the Contact cube face. The skill documentation explicitly lists avoiding optimistic UI as a common mistake, recommending standard state updates through the documented handlers instead.