Project Human README

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

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

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.

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.