io.github.humanity4ai/project-human

Humanity4AI

9 humanity skills for AI agents — crisis detection, accessibility auditing, empathy, cultural sensitivity, and more. Ready-to-use via MCP, npm, or direct prompting.

---

Skills at a Glance

Skill	Category	What it does
🛡️ Supportive Reply	Emotional Safety	Detects crisis signals, generates supportive responses with escalation guidance
📝 Safe Content Rewriter	Emotional Safety	Audits and rewrites text to remove harmful, stigmatising, or triggering patterns
♿ Accessibility Audit	Accessibility	Scores pages against all 86 WCAG 2.2 success criteria (A/AA/AAA)
🧠 Cognitive Accessibility	Cognitive Support	Audits content for reading level, structure, and cognitive load
🌍 Cultural Context Check	Cultural Context	Flags cultural sensitivity issues for a given audience and region
🔥 De-escalation Plan	Conflict Navigation	Generates structured de-escalation plans calibrated to conflict intensity
💬 Empathetic Reframe	Communication	Reframes messages with genuine empathy, catching hollow empathy patterns
🧩 Neurodiversity Design	Neurodiversity	Audits UIs for ADHD, autism, dyslexia, and sensory sensitivity
👶 Age-Inclusive Design	Age Inclusion	Audits user flows for age barriers across children, adults, and older users

---

Quick Start

Zero setup — just a URL:

{
  "mcpServers": {
    "humanity4ai": {
      "url": "https://humanity4ai.ascent.partners/api/mcp"
    }
  }
}

Or one command with npx:

npx @humanity4ai/mcp-servers

Then configure your MCP client:

{
  "mcpServers": {
    "humanity4ai": {
      "command": "npx",
      "args": ["-y", "@humanity4ai/mcp-servers"]
    }
  }
}

Docker: docker compose up
For contributors: git clone … && pnpm install && pnpm start

All 9 skills are discoverable via tools/list and invocable via tools/call.

Prerequisites (for local only): Node.js >= 22, pnpm >= 10 | Windows, macOS, Linux, Android, iOS

---

Architecture

graph TD
    A[MCP Client<br/>VS Code / Cursor / Claude Code] -->|stdio| B[mcp-server.ts]
    A -->|HTTP POST| C[Vercel<br/>humanity4ai.ascent.partners]
    B --> D[server-factory.ts<br/>createServer]
    C -->|api/mcp.ts| D
    D --> E[9 Tool Registrations]
    E --> F[handlers.ts<br/>invokeAction]
    F --> G[validate.ts<br/>SCHEMA_REGISTRY]
    G --> H[schemas-data.ts<br/>18 inline schemas]
    F --> I[9 Handler Functions<br/>rule-based, zero LLM calls]
    I --> J[crisis-resources<br/>patterns<br/>i18n<br/>wcag-criteria]

Four Ways to Use

Method	Best for	How
Remote URL	Zero-setup, any MCP client	Point to https://humanity4ai.ascent.partners/api/mcp
MCP Server	VS Code, Cursor, Claude Code, Copilot, Manus AI, OpenCode	npx @humanity4ai/mcp-servers or clone & start
LLM Prompting	ChatGPT, Claude, Gemini (web chat)	Share llms.txt or paste llms-full.txt into the chat
Local Files	Offline CLI tools	Clone the repo, point your tool at the skills/ directory

See Agent Adapter Guide for platform-specific setup instructions.

---

Why Humanity4AI?

AI agents are everywhere — but they're not always humane. Humanity4AI gives agents reusable, tested skills for the moments that matter:

• An agent detects a user in crisis → Supportive Reply generates an appropriate response and escalates to qualified help
• A UI is inaccessible to screen readers → Accessibility Audit scores it against WCAG 2.2 and provides remediation
• Content uses stigmatising language → Safe Content Rewriter flags and rewrites harmful patterns
• A conflict is escalating → De-escalation Plan generates structured, non-coercive guidance

Every skill includes:

• Explicit safety boundaries — what the skill can and cannot do
• Uncertainty disclosure — confidence level stated upfront (low/medium/high)
• Evaluation gates — automated baseline checks for quality

These skills are rule-based and non-clinical — they do not provide diagnosis, treatment, or professional medical/legal advice.

---

Supported Platforms

OpenCode · Claude Code · Microsoft Copilot · Manus AI · OpenClaw · ChatGPT · Claude · Gemini

---

Contributing

git clone https://github.com/<your-username>/project_human.git
cd project_human
git checkout -b my-contribution
# Copy the skill template if adding a new skill:
cp -r templates/skill skills/my-skill-name
pnpm check && pnpm evals && pnpm test  # Run all checks before PR

Open a PR targeting main. Browse good first issues or read the Contributing Guide.

Error	Fix
ERR_PNPM_OUTDATED_LOCKFILE	Run pnpm install, then commit pnpm-lock.yaml
pnpm: command not found	npm install -g pnpm
pnpm evals fails	EVAL_REPORT=1 pnpm evals — see evals/reports/latest.md

---

Resources

• Contributing Guide
• Agent Adapter Guide
• Governance
• Roadmap
• Release Process
• Public Site

License

MIT — see LICENSE.

---

A Humanity4AI project by Ascent Partners Foundation.

If this saves you time, a ⭐ on GitHub helps others find it.