К основному содержанию
скилл CX Codex

hipaa-compliance · curiositech — скилл для Claude Code: что делает и установка

Скилл hipaa-compliance помогает проверять работу с PHI: аудит доступа, санитаризацию логов и требования к сессиям. Нужен при разработке функций с медицинскими данными.

MIT 215 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill hipaa-compliance -a claude-code
Открыть на GitHub

Что делает hipaa-compliance

hipaa-compliance подсказывает, какие операции с PHI нужно журналировать: просмотр, создание, изменение, удаление и экспорт данных, действия администратора, неудачные входы и события безопасности. В качестве PHI рассматриваются check-ins, записи журнала, чаты, профиль пользователя, дата трезвости и экстренные контакты.

Скилл использует утилиты из src/lib/hipaa/audit.ts: logPHIAccess, logPHIModification, logSecurityEvent и logAdminAction. Он также проверяет, чтобы в журналах оставались идентификаторы и метаданные, а не содержимое записей, и напоминает о шифровании, контроле доступа и сроке хранения аудита в 6 years.

В рекомендациях есть сессия с тайм-аутом 15 minutes, максимумом 8 hours и блокировкой после 5 попыток входа на 30 minute. Для аварийного доступа предусмотрен src/lib/hipaa/break-glass. Если в проекте нет src/lib/hipaa/audit.ts, примеры логирования придётся адаптировать.

Какие задачи решает

  • проверить доступ к PHI в API-маршрутах
  • добавить аудит просмотра и изменения записей
  • убрать содержимое медицинских данных из логов
  • настроить контроль сессий и неудачных входов
  • оформить аварийный доступ с отдельным аудитом

Примеры запросов агенту

  • Проверь этот API-маршрут: все операции с PHI должны попадать в аудит через src/lib/hipaa/audit.ts.
  • Перепиши логирование записи журнала так, чтобы в нём оставались только идентификатор и метаданные, без содержимого.
  • Проверь функцию аварийного доступа через src/lib/hipaa/break-glass и добавь обязательное обоснование.

Как установить hipaa-compliance

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill hipaa-compliance -a claude-code

2Вручную: положить файлы

~/.claude/skills/hipaa-compliance/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hipaa-compliance/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hipaa-compliance

Как установить hipaa-compliance в Claude Code?

Выполните npx skills add curiositech/some_claude_skills --skill hipaa-compliance -a claude-code, затем проверьте файл ~/.claude/skills/hipaa-compliance/SKILL.md.

Что делает скилл hipaa-compliance?

Он помогает учитывать требования HIPAA при работе с PHI: журналировать доступ, изменения и события безопасности, не записывать содержимое данных в логи и проверять защиту сессий.

Какие данные скилл считает PHI?

К PHI относятся check-ins, записи журнала, чаты, профиль пользователя, дата трезвости и экстренные контакты. Агрегированная аналитика и просмотры страниц без содержимого указаны отдельно.

Исходный текст

SKILL.md · MIT
---
name: hipaa-compliance
description: Ensure HIPAA compliance when handling PHI (Protected Health Information). Use when writing code that accesses user health data, check-ins, journal entries, or any sensitive information. Activates
  for audit logging, data access, security events, and compliance questions.
allowed-tools: Read,Write,Edit
metadata:
  category: Code Quality & Testing
  tags:
  - hipaa
  - compliance
  - security
  pairs-with:
  - skill: recovery-app-legal-terms
    reason: HIPAA requirements directly inform privacy policy and terms of service content for health apps
  - skill: security-auditor
    reason: HIPAA technical safeguards overlap with security vulnerability scanning and access controls
  - skill: recovery-social-features
    reason: Social features handling health data must comply with HIPAA privacy and consent rules
  - skill: crisis-response-protocol
    reason: Crisis responses involving health disclosures must follow HIPAA breach notification rules
---

# HIPAA Compliance for Recovery Coach

This skill helps you maintain HIPAA compliance when developing features that handle Protected Health Information (PHI).

## What is PHI in This Application?

| Data Type | PHI Status | Handling |
|-----------|------------|----------|
| Check-in mood/cravings | PHI | Audit all access |
| Journal entries | PHI | Audit all access |
| Chat conversations | PHI | Audit all access |
| User profile (name, email) | PHI | Audit modifications |
| Sobriety date | PHI | Audit access |
| Emergency contacts | PHI | Audit access |
| Usage analytics (aggregated) | NOT PHI | No audit needed |
| Page views (no content) | NOT PHI | No audit needed |

## Audit Logging Requirements

### When to Log

**Always log these operations:**
- Viewing any PHI (check-ins, journal, messages)
- Creating/updating/deleting PHI
- Exporting user data
- Admin access to user information
- Failed authentication attempts
- Security events (rate limiting, unauthorized access)

### How to Log

Use the audit logging utilities in `src/lib/hipaa/audit.ts`:

```typescript
import {
  logPHIAccess,
  logPHIModification,
  logSecurityEvent,
  logAdminAction
} from '@/lib/hipaa/audit';

// Viewing PHI
await logPHIAccess(
  userId,
  'checkin',        // targetType
  checkinId,        // targetId
  AuditAction.PHI_VIEW
);

// Modifying PHI
await logPHIModification(
  userId,
  'journal',
  journalId,
  AuditAction.PHI_UPDATE,
  { field: 'content' }  // Never include actual content!
);

// Security event
await logSecurityEvent(
  userId,
  AuditAction.RATE_LIMIT,
  { path: '/api/chat', attempts: 60 }
);

// Admin action
await logAdminAction(
  adminId,
  AuditAction.ADMIN_USER_VIEW,
  'user',
  targetUserId
);
```

## Data Sanitization

### Never Log These Fields

The audit system automatically sanitizes, but be explicit:

```typescript
// BAD - Contains PHI
await logPHIAccess(userId, 'journal', id, action, {
  content: journalEntry.content  // NEVER DO THIS
});

// GOOD - Only metadata
await logPHIAccess(userId, 'journal', id, action, {
  wordCount: journalEntry.content.length,
  hasAttachments: false
});
```

### Sanitized Fields (Auto-Redacted)

- `password`, `token`, `secret`, `key`
- `authorization`, `cookie`, `session`
- `credential`, `content`, `message`, `notes`

## Session Security Requirements

From `src/lib/auth.ts`:

- **Session timeout**: 15 minutes of inactivity (HIPAA requirement)
- **Max session**: 8 hours absolute maximum
- **Failed login lockout**: 5 attempts = 30 minute ban
- **Password requirements**: 12+ chars, mixed case, numbers, special chars

## Code Patterns

### API Route with Audit Logging

```typescript
import { getSession, requireAuth } from '@/lib/auth';
import { logPHIAccess } from '@/lib/hipaa/audit';

export async function GET(request: Request) {
  const session = await getSession();
  if (!session) {
    return Response.json({ error: 'Unauthorized' }, { status: 401 });
  }

  // Fetch the data
  const data = await fetchUserData(session.userId);

  // Log the access
  await logPHIAccess(
    session.userId,
    'userdata',
    session.userId,
    AuditAction.PHI_VIEW
  );

  return Response.json(data);
}
```

### Component with PHI Access

```typescript
'use client';

import { useEffect } from 'react';

export function JournalViewer({ entryId }: { entryId: string }) {
  useEffect(() => {
    // Log view on mount (server-side preferred, but client backup)
    fetch('/api/audit/log', {
      method: 'POST',
      body: JSON.stringify({
        action: 'PHI_VIEW',
        targetType: 'journal',
        targetId: entryId
      })
    });
  }, [entryId]);

  // ... render
}
```

## Compliance Checklist

Before shipping any feature that touches PHI:

- [ ] All PHI access is audit logged
- [ ] No PHI content in logs (only IDs and metadata)
- [ ] Data access requires authentication
- [ ] Admin access has separate audit trail
- [ ] Failed access attempts are logged
- [ ] Data export includes audit entry
- [ ] Sensitive fields are encrypted at rest
- [ ] Session timeout is enforced

## Audit Log Retention

- **Minimum**: 6 years (HIPAA requirement)
- **Format**: Raw logs for 1 year, compressed thereafter
- **Location**: `audit_log` table in database
- **Export**: Encrypted exports for compliance audits

## Emergency Access (Break Glass)

For emergency situations, use break-glass access:

```typescript
import { requestBreakGlassAccess } from '@/lib/hipaa/break-glass';

// This creates enhanced audit trail
const access = await requestBreakGlassAccess(
  adminId,
  targetUserId,
  'Emergency support required - user reported crisis'
);
```

Break glass access:
- Requires written justification
- Creates permanent audit record
- Triggers alert to compliance officer
- Must be reviewed within 24 hours

## Resources

- HIPAA Security Rule: 45 C.F.R. § 164.312
- Audit controls standard: 45 C.F.R. § 164.312(b)
- Incident response plan: `docs/INCIDENT-RESPONSE-PLAN.md`
- Security documentation: `docs/SECURITY-HARDENING.md`

© curiositech · MIT · curiositech/some_claude_skills

Похожие скиллы

Все скиллы по теме «Безопасность» →

Сначала — hipaa-compliance от других авторов.

hipaa-compliance affaan-m Скилл hipaa-compliance работает в Claude Code и других платформах, обеспечивая соблюдение требований HIPAA при обработке персональных медицинских данных в ПО. CX Codex +1 6 200установок hipaa-compliance devops-skills Скилл hipaa-compliance помогает разбирать требования HIPAA и настраивать защиту ePHI. Пригодится при работе с медицинскими данными и подготовке облачной инфраструктуры. CX Codex +1 357установок hipaa-audit briiirussell Скилл hipaa-audit для Claude Code проверяет приложения и инфраструктуру, работающие с PHI, по требованиям HIPAA и HITECH. Проводит технический аудит медицинских данных. CX Codex +1 401установок healthcare-phi-compliance affaan-m Скилл healthcare-phi-compliance для Claude Code содержит паттерны защиты PHI и PII для HIPAA, GDPR и DISHA, включая настройку RLS, аудит доступа и предотвращение утечек в логах и URL. CX Codex +1 6 300установок VLayer abasensei MCP-сервер VLayer проверяет исходный код на требования HIPAA. Находит утечки медицинских данных, проблемы шифрования и предлагает готовые исправления. CX Codex +1 1 871установок compliance-automation-specialist Alysson Franklin Субагент compliance-automation-specialist помогает выстроить автоматический сбор доказательств, мониторинг контролей и подготовку к аудитам SOC 2, ISO 27001 или GDPR. CX Codex ★ 1 013звёзд репо data-privacy-compliance davila7 Скилл data-privacy-compliance помогает настроить обработку персональных данных по правилам GDPR, CCPA и HIPAA прямо в кодовой базе проекта. CX Codex +1 259установок ai-agent-audit-specialist davila7 Субагент ai-agent-audit-specialist проектирует и проверяет неизменяемые аудиторские журналы для ИИ-агентов под требования HIPAA, SOC 2, ISO 27001 и EU AI Act. CX Codex 148установок

Из того же набора180

Весь набор →
team-builder Скилл team-builder проектирует структуру команды по принципам организационной психологии. Если нужной роли нет в библиотеке скиллов, сразу создаёт её. CX Codex +1 216установок react-performance-optimizer Скилл react-performance-optimizer находит узкие места в рендере React-приложений для достижения 60fps. Решает проблемы с зависанием списков и раздутыми бандлами. CX Codex +1 215установок digital-estate-planner Скилл digital-estate-planner для Claude Code планирует цифровое наследство: учитывает аккаунты, пароли и криптоактивы, готовит инструкции доверенным лицам. Помогает подготовить доступ к данным на случай смерти или недееспособности. CX Codex +1 215установок data-pipeline-engineer Скилл data-pipeline-engineer проектирует пайплайны данных, слои Medallion, DAG для Airflow и модели dbt. Пригодится при настройке пакетной или потоковой обработки данных. CX Codex +1 215установок web-wave-designer Скилл web-wave-designer для Claude Code генерирует водные эффекты для веба: океанские волны, рябь и подводное искажение. Создаёт живые фоны и интерфейсы с эффектом жидкости. CX Codex +1 214установок test-automation-expert Скилл test-automation-expert для Claude Code помогает выстроить стратегию тестирования, определить покрытие, выбрать фреймворк и отладить флаки-тесты. CX Codex +1 212установок very-long-text-summarization Скилл very-long-text-summarization для обработки книг, справочников и больших кодбаз через многоуровневое извлечение знаний. Выдаёт карту знаний, а не просто сжатый пересказ. CX Codex +1 210установок rest-api-design Скилл rest-api-design помогает проектировать REST-маршруты с проверкой данных через Zod и документацией OpenAPI. Пригодится при создании API для Next.js App Router. CX Codex +1 209установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой