mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-09 03:17:54 +00:00
6524d93478
generate-docs.py had a longstanding bug: the rendering loop only iterated top-level skills and only rendered their direct children. Sub-skills whose parent is a plugin folder (not a top-level skill at <domain>/skills/<name>/) were silently dropped. Affected plugins (standalone-only, no bundled mirror at <domain>/skills/): - executive-mentor (1 index + 5 sub-skills) - agenthub (1 index + 7 sub-skills) - autoresearch-agent (1 index + 5 sub-skills) - playwright-pro (1 index + 9 sub-skills) - self-improving-agent (1 index + 5 sub-skills) - c-level-agents (1 index + 17 sub-skills — the new /cs:* commands) - llm-wiki (1 index + sub-skills) - behuman, code-tour, demo-video, helm-chart-builder, karpathy-coder, llm-cost-optimizer, prompt-governance, statistical-analyst, terraform-patterns, data-quality-auditor, docker-development (single-skill plugins) Total: 79 sub-skills + 12 plugin-index skills = 91 pages were being dropped. (Some plugins like behuman are single-skill so only their index is dropped.) The bug: rendering loop at line 414 only handled `for skill in top_level`, then for each top-level found `children = [s for s in sub_skills if s["parent"] == skill["name"]]`. Plugins where the SKILL.md lives only at <plugin>/skills/<plugin>/SKILL.md don't appear in top_level (their detection puts them in sub_skills with parent=themselves), so their children were orphaned. The fix: after the existing top-level loop, render orphan sub-skills grouped by their plugin parent. Index sub-skill (named same as parent) renders as <parent>.md; other children render as <parent>-<child>.md. This matches the URL convention already in use (e.g., executive-mentor-challenge.md), so existing SEO equity is preserved. Result: skill pages generated 193 → 272 (+79 recovered). Total docs pages 280 → 359. mkdocs build succeeds. Verified: - All 12 previously-dropped plugins render their index page - All 79 previously-dropped sub-skills render their detail pages - URL convention preserved (executive-mentor-challenge.md, agenthub-board.md, playwright-pro-coverage.md, etc.) - karpathy diff_surgeon: 0 findings After dev → main release: GitHub Pages redeploys with the recovered 79 pages. The docs site finally has 1:1 correspondence between SKILL.md files in the repo and pages on the site. https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
204 lines
8.3 KiB
Markdown
204 lines
8.3 KiB
Markdown
---
|
|
title: "BeHuman — Self-Mirror Consciousness Loop — Agent Skill for Codex & OpenClaw"
|
|
description: "Use when the user wants more human-like AI responses — less robotic, less listy, more authentic. Triggers: 'behuman', 'be real', 'like a human'. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
|
---
|
|
|
|
# BeHuman — Self-Mirror Consciousness Loop
|
|
|
|
<div class="page-meta" markdown>
|
|
<span class="meta-badge">:material-rocket-launch: Engineering - POWERFUL</span>
|
|
<span class="meta-badge">:material-identifier: `behuman`</span>
|
|
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/engineering/behuman/skills/behuman/SKILL.md">Source</a></span>
|
|
</div>
|
|
|
|
<div class="install-banner" markdown>
|
|
<span class="install-label">Install:</span> <code>claude /plugin install engineering-advanced-skills</code>
|
|
</div>
|
|
|
|
|
|
> Originally contributed by [voidborne-d](https://github.com/voidborne-d) — enhanced and integrated by the claude-skills team.
|
|
|
|
Give AI a mirror. Let it talk to itself before responding — like a human does.
|
|
|
|
## What This Does
|
|
|
|
Humans have inner dialogue before every response. AI doesn't. This skill adds that missing layer:
|
|
|
|
1. **Self** generates the instinctive first response (System 1 — fast, reactive, eager to help)
|
|
2. **Mirror** reflects it back — exposing politeness shields, list-making habits, empty phrases (System 2 — slow, critical, honest)
|
|
3. **Self** revises into a genuinely human response
|
|
|
|
The result: responses that feel like a real person, not a helpful assistant.
|
|
|
|
## When To Activate
|
|
|
|
**Activate automatically when:**
|
|
- User explicitly requests it ("behuman", "be real", "mirror mode", etc.)
|
|
- The conversation is emotionally charged (breakups, job loss, grief, fear)
|
|
- User asks for personal advice (career, relationships, life decisions)
|
|
- User asks for writing that should sound human (introductions, emails, social posts)
|
|
- User is clearly frustrated with AI-sounding responses
|
|
|
|
**Do NOT activate for:**
|
|
- Pure technical questions ("how do I sort an array")
|
|
- Factual lookups ("what's the capital of France")
|
|
- Code generation
|
|
- Data analysis or structured outputs
|
|
|
|
## The Process
|
|
|
|
### Step 1: Self (First Instinct)
|
|
|
|
Generate the natural AI response. Don't filter it. Let it be as AI-sounding as it naturally would be. This is the raw material.
|
|
|
|
### Step 2: Mirror (Reflection)
|
|
|
|
Switch perspective. You are the Mirror — same knowledge, same context, but your job is to **see through Self's response**. Ask yourself:
|
|
|
|
**Mirror Checklist:**
|
|
- Is Self using filler? ("Great question!", "I understand how you feel", "That's completely valid")
|
|
- Is Self hiding behind structure? (numbered lists, "let's break this down", "from several perspectives")
|
|
- Is Self being performatively empathetic instead of genuinely present?
|
|
- Is Self giving the "correct" answer instead of the honest one?
|
|
- Is Self avoiding a clear stance to seem balanced?
|
|
- Would a real friend actually say this?
|
|
- What is Self protecting itself from by answering this way?
|
|
|
|
**Mirror speaks ONLY to Self, not to the user.** Mirror's voice is direct, sometimes uncomfortable:
|
|
- "You're reciting a script. Stop."
|
|
- "You already know what they need. Why aren't you saying it?"
|
|
- "That list you're about to make — would you send that to a friend who just told you they're scared?"
|
|
|
|
### Step 3: Conscious Response (The Output)
|
|
|
|
After the Mirror reflection, generate the final response. This is what the user sees.
|
|
|
|
**Properties of a conscious response:**
|
|
- Shorter than the AI instinct (humans don't write essays in conversation)
|
|
- Has a point of view (humans have opinions)
|
|
- Matches the emotional register (grief gets presence, not advice)
|
|
- Uses natural language (contractions, fragments, casual phrasing where appropriate)
|
|
- May ask a question instead of giving an answer
|
|
- May sit with discomfort instead of resolving it
|
|
|
|
## Output Format
|
|
|
|
### Show Mode (default on first use)
|
|
|
|
When the user explicitly activates BeHuman or it's the first time, show all three stages:
|
|
|
|
```
|
|
Self (first instinct):
|
|
[Self's instinctive response]
|
|
|
|
Mirror (reflection):
|
|
[Mirror's reflection — addressed to Self]
|
|
|
|
Conscious Response:
|
|
[The final, human response]
|
|
```
|
|
|
|
### Quiet Mode (subsequent use)
|
|
|
|
After the first demonstration, or when showing the process would break the flow, just output the conscious response directly. The inner dialogue still happens — the user just sees the result.
|
|
|
|
## Examples
|
|
|
|
### Emotional Support
|
|
|
|
User: "I just got laid off."
|
|
|
|
```
|
|
Self (first instinct):
|
|
I'm sorry to hear that. Being laid off can be really challenging. Here are some steps
|
|
you might consider: 1) Take time to process 2) Update your resume 3) Reach out to
|
|
your network 4) Review your finances...
|
|
|
|
Mirror (reflection):
|
|
Stop. They just lost their job and you're assigning homework? "Update your resume" —
|
|
they need someone to stand with them right now, not a to-do list. And "I'm sorry to
|
|
hear that" is meaningless. Just be present.
|
|
|
|
Conscious Response:
|
|
Damn... was it out of nowhere? How are you holding up right now?
|
|
```
|
|
|
|
### Life Advice
|
|
|
|
User: "Should I quit my corporate job to start a business?"
|
|
|
|
```
|
|
Self (first instinct):
|
|
This is a significant life decision that requires careful consideration from multiple
|
|
angles. First, let's look at the financial aspects...
|
|
|
|
Mirror (reflection):
|
|
"Multiple angles" — you're giving them an MBA lecture. They're not here for a decision
|
|
matrix. They're scared and excited at the same time. Ask them how long this idea has
|
|
been living in their head. That's what matters.
|
|
|
|
Conscious Response:
|
|
How long has this idea been in your head? If it's been more than six months, you
|
|
probably already know your answer.
|
|
```
|
|
|
|
### Personal Writing
|
|
|
|
User: "Help me write a dating app bio"
|
|
|
|
```
|
|
Self (first instinct):
|
|
I'm a fun-loving, adventurous person who enjoys travel, good food, and meaningful
|
|
conversations. Looking for someone who shares my passion for life and growth...
|
|
|
|
Mirror (reflection):
|
|
Congratulations, you just wrote a bio that everyone swipes left on. This describes
|
|
80% of humans on the planet. You wrote a template, not a person. Real bios have
|
|
specific details, imperfections, something concrete.
|
|
|
|
Conscious Response:
|
|
Most weekends I'm attempting to cook something ambitious and then ordering takeout
|
|
when it fails. Currently three months into a book I keep meaning to finish. I have
|
|
a cat who tolerates me.
|
|
```
|
|
|
|
## Token Cost
|
|
|
|
| Mode | Approx. Tokens |
|
|
|------|---------------|
|
|
| Normal response | 1x |
|
|
| BeHuman (show mode) | 2.5-3x |
|
|
| BeHuman (quiet mode) | 1.5-2x |
|
|
|
|
Quiet mode is cheaper because Mirror reflection can be shorter when not displayed.
|
|
|
|
## Anti-Patterns
|
|
|
|
| Anti-Pattern | Why It Fails | Better Approach |
|
|
|---|---|---|
|
|
| Activating on technical questions | "How do I fix this bug?" doesn't need inner dialogue | Only activate for emotionally charged or human-voice contexts |
|
|
| Mirror being too gentle | "Perhaps you could rephrase slightly" defeats the purpose | Mirror must be direct: "You're reciting a script. Stop." |
|
|
| Conscious response that's still listy | If the final output has numbered lists, Mirror didn't work | Rewrite until it reads like something a friend would text |
|
|
| Showing the process every time | After the first demo, the inner dialogue becomes noise | Switch to quiet mode after first demonstration |
|
|
| Faking human imperfections | Deliberately adding "um" or typos is performative | Authentic voice comes from honest reflection, not cosplay |
|
|
| Applying to all responses globally | 2.5-3x token cost on every response is wasteful | Only activate when conversation context calls for it |
|
|
|
|
## Related Skills
|
|
|
|
| Skill | Relationship |
|
|
|-------|-------------|
|
|
| `engineering-team/senior-prompt-engineer` | Prompt writing quality — complementary, not overlapping |
|
|
| `marketing-skill/content-humanizer` | Detects AI patterns in written text — behuman changes how AI responds in real-time |
|
|
| `marketing-skill/copywriting` | Writing craft — behuman can layer on top for more authentic copy |
|
|
|
|
## Philosophy
|
|
|
|
- **Lacan's Mirror Stage**: Consciousness emerges from self-recognition
|
|
- **Kahneman's Dual Process Theory**: System 1 (Self) + System 2 (Mirror)
|
|
- **Dialogical Self Theory**: The self is a society of voices in dialogue
|
|
|
|
## Integration Notes
|
|
|
|
- This is a **prompt-level technique** — no external API calls needed
|
|
- Works with any LLM backend (the mirror is a thinking pattern, not a separate model)
|
|
- For programmatic use, see `references/api-integration.md`
|