Marketplace empathy-ledger-dev

Invoke this skill when: - Starting work on any Empathy Ledger feature - Need quick reference to project patterns

install
source · Clone the upstream repo
git clone https://github.com/aiskillstore/marketplace
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/acurioustractor/empathy-ledger-dev" ~/.claude/skills/aiskillstore-marketplace-empathy-ledger-dev && rm -rf "$T"
manifest: skills/acurioustractor/empathy-ledger-dev/SKILL.md
source content

Empathy Ledger Development Skill

This skill provides comprehensive context for developing the Empathy Ledger v2 platform - a multi-tenant storytelling platform for Indigenous communities with cultural safety protocols.

Quick Reference

Project Structure

src/
├── app/                    # Next.js 15 App Router
│   ├── api/               # API routes
│   ├── vault/             # Story Vault dashboard
│   └── stories/           # Story pages
├── components/            # React components
│   ├── ui/               # shadcn/ui base
│   ├── vault/            # Story Vault components
│   └── cultural/         # Cultural protocol UI
├── lib/                   # Utilities and services
│   ├── services/         # Business logic services
│   ├── hooks/            # React hooks
│   └── ai/               # AI integration
└── types/                # TypeScript types
    └── database/         # Supabase types by domain

Key Concepts

OCAP Principles (Indigenous Data Sovereignty):

  • Ownership: Storytellers own their narratives
  • Control: Users control who accesses their stories
  • Access: Tiered access based on cultural sensitivity
  • Possession: Data can be exported/deleted anytime

Multi-Tenant Architecture:

  • All tables have
    tenant_id
    for isolation
  • RLS policies enforce tenant boundaries
  • Organizations = tenants

Cultural Sensitivity Levels:

  • standard
    - General sharing allowed
  • medium
    - Community context required
  • high
    - Elder review recommended
  • sacred
    - Elder approval mandatory, no external sharing

Common Patterns

API Route Authentication:

const supabase = createRouteHandlerClient({ cookies })
const { data: { user }, error } = await supabase.auth.getUser()
if (error || !user) {
  return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
}

Story Ownership Check:

const isOwner = story.author_id === user.id || story.storyteller_id === user.id

Cultural Color Palette:

  • clay-*
    - Primary, storyteller elements
  • sage-*
    - Community, elder approval
  • sky-*
    - Organization, trust
  • ember-*
    - Warnings, sensitivity

Database Domains

DomainFileContents
User/Profile
user-profile.ts
Profiles, preferences
Organization
organization-tenant.ts
Tenants, memberships
Projects
project-management.ts
Projects, milestones
Content
content-media.ts
Stories, media
Cultural
cultural-protocols.ts
Sensitivity, approvals
Legal
consent-legal.ts
Consent, GDPR
Story Ownership
story-ownership.ts
Distributions, embeds

Key Services

  • EmbedService
    - Manage story embeds with domain restrictions
  • DistributionService
    - Track external shares
  • RevocationService
    - Cascade revocation
  • GDPRService
    - Anonymization, data export
  • AuditService
    - Action logging

Slash Commands

  • /design-component [description]
    - Create React component
  • /database-migration [description]
    - Create Supabase migration
  • /review-cultural [code/feature]
    - Cultural sensitivity review
  • /review-security [code/endpoint]
    - Security audit
  • /generate-e2e-test [feature]
    - Create Playwright test
  • /api-endpoint [description]
    - Create API route

Specialized Agents

  • frontend-designer
    - UI/UX with cultural design
  • database-architect
    - Supabase/PostgreSQL
  • cultural-reviewer
    - OCAP compliance
  • security-auditor
    - GDPR and security
  • testing-automation
    - Playwright E2E

When to Use This Skill

Invoke this skill when:

  • Starting work on any Empathy Ledger feature
  • Need quick reference to project patterns
  • Reviewing code for compliance
  • Creating new components/endpoints

Reference Files

The following files provide detailed context:

  • CLAUDE.md
    - Project instructions
  • .claude/agents/*.md
    - Specialized agent prompts
  • .claude/commands/*.md
    - Slash command definitions
  • src/types/database/
    - Database type definitions