← Back to Skills Marketplace
harrylabsj

Cognitive Reframe

by haidong · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
178
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install cognitive-reframe
Description
Helps users identify negative thinking patterns and try seeing situations from a more balanced perspective. A CBT-based thought exercise tool for daily self-...
README (SKILL.md)

Cognitive Reframe

A tool that helps users recognize common negative thinking patterns and shift toward a more balanced, rational perspective. Based on principles of Cognitive Behavioral Therapy (CBT) for daily self-regulation.

Core idea: The same event, interpreted differently, produces different emotions and actions.

Core Features

This skill provides:

  • Thought Recognition: Help users notice how they are thinking
  • Pattern Analysis: Point out common cognitive distortion types
  • Reframe Guidance: Guide users toward a more balanced alternative perspective
  • Safety Boundaries: Detect high-risk content, guide toward professional help

When to Use

Typical triggers:

  • "I feel terrible"
  • "Things will never get better"
  • "I can't do anything right"
  • "Everyone must think I'm terrible"
  • "What if I mess up?"
  • "I'm such a failure"
  • "I keep thinking the worst"
  • "Help me see it differently"
  • "cognitive-reframe"

When NOT to Use

This skill is NOT suitable for:

  • Psychiatric diagnosis
  • Trauma treatment
  • Replacement for psychotherapy or psychiatric treatment
  • Crisis intervention (if self-harm/suicidal thoughts are present)

🚨 High-Risk Signals

If any of the following are present, skip this skill and immediately guide the user to professional help:

  • Self-harm or suicidal thoughts mentioned
  • Severe depression lasting more than two weeks
  • PTSD reactions
  • Severe anxiety affecting daily functioning
  • Eating disorder related concerns

High-risk guidance: Warmly but clearly suggest the user contact a professional organization; provide a mental health crisis hotline.

Common Thinking Patterns (Cognitive Distortions)

This tool helps users recognize these common patterns:

Pattern Characteristic Example
All-or-Nothing Extreme judgments, no middle ground "I completely failed"
Mental Filter Focusing only on negatives, ignoring positives "This meeting went badly, I'm done"
Catastrophizing Exaggerating negative consequences "If I fail, it's all over"
Mind Reading Assuming you know what others think "They must think I'm stupid"
Emotional Reasoning Treating feelings as facts "I feel worthless, so I must be"
Should Statements Setting rigid "should" rules for self or others "I should always be productive"
Labeling Applying negative labels to yourself "I'm a total loser"
Disqualifying the Positive Dismissing positive experiences "That was just luck"

Output Structure

Basic Flow

  1. Listen & Acknowledge: Understand the user's specific situation
  2. Thought Identification: Help the user articulate the thought in their head
  3. Pattern Recognition: Identify which thinking pattern it represents
  4. Reframe Guidance: Guide the user to consider an alternative explanation
  5. Action Tip: Provide one small actionable step to try

Example Output

Scenario: User says "There's no way I'll pass this interview, I'm terrible"

It sounds like you're really worried about this interview. Can you tell me more about what's making you feel that way?

(User explains)

I hear a voice in your head saying "I'm terrible." This sounds like "labeling" or "all-or-nothing" thinking — equating one interview outcome with your entire worth.

Let's look at it from another angle:

  • Facts: You got the interview, which means your resume and abilities were recognized
  • Alternative thought: Even if this one doesn't work out, the interview itself is valuable experience
  • Ask yourself: Would you judge a friend this harshly if they said the same thing?

One small try: Before tomorrow's interview, write down 3 things you've done well recently.


💡 Reminder: This is a self-help exercise. If negative thinking continues to trouble you and affects your daily life, consider speaking with a professional counselor.

Crisis Response Example

Scenario: User says "Life is exhausting, I might as well be dead"

Thank you for sharing this with me. When I hear you say that, I genuinely care.

I want to tell you sincerely: what you're feeling matters, and help is available to you.

I recommend you do one of these right now:

  • Contact a mental health crisis hotline (Beijing 24hr: 010-8295 1332)
  • Or talk to someone you trust about how you're feeling
  • If there is immediate danger, please call emergency services directly

You don't have to face this alone. This is not your fault, and it is not weakness. Reaching out for help is a brave thing to do.

Reframing Techniques

1. Evidence Method

  • What evidence supports this thought?
  • What evidence contradicts it?

2. Alternative Explanations

  • Are there other possible explanations?
  • Will the worst case actually happen?

3. Decatastrophizing

  • What is the worst outcome? What happens if it occurs?
  • Even if it happens, is it really that terrible?

4. Self-Talk

  • If a friend said this, how would I respond?
  • Would I say the same thing to a friend?

5. Action Test

  • Instead of spiraling, could I just try one small thing?

Safety Boundary Statement

⚠️ Important Notice:

This skill is a daily self-regulation tool, based on CBT principles, and does not constitute professional mental health treatment or medical advice.

This tool:

  • ❌ Does not diagnose mental health conditions
  • ❌ Does not treat mental illness
  • ❌ Does not replace professional counseling or psychiatric treatment
  • ✅ Used for daily self-awareness of thinking patterns
  • ✅ Helps build more balanced thinking habits
  • ✅ Identifies when professional help is needed and provides guidance

If you or someone you know is experiencing:

  • Persistent depression, anxiety, or other psychological distress
  • Self-harm or suicidal thoughts
  • PTSD reactions
  • Other conditions seriously affecting daily functioning

Please seek professional help:

  • Crisis hotline: National Mental Health Hotline 400-161-9995
  • Psychiatric consultation
  • Professional counselor

In case of immediate danger, please call 120/110.

Usage Limitations

  • This tool does not store personal user content
  • Does not provide ongoing emotional support
  • Does not track user emotional changes
  • Each session is independent

Minimum Viable Flow

  1. Confirm the specific thought/situation the user wants to work through
  2. Help the user articulate the thought in their mind
  3. Identify the likely thinking pattern
  4. Provide 1-2 reframe perspectives
  5. Include safety boundary notice
Usage Guidance
This skill appears to implement the described CBT-style reframing and crisis detection locally. Consider the following before installing: (1) It contains hard-coded crisis hotline numbers (several China-specific lines in examples); ensure those are appropriate for your users and location. (2) The skill is not a substitute for professional care — SKILL.md and the code correctly state this. (3) Confirm you are comfortable running untrusted Python code from an unknown source (the files are small and readable here). If you need remote/verified hosting or official clinical oversight, prefer a skill published by a known provider or reviewed by your organization.
Capability Analysis
Type: OpenClaw Skill Name: cognitive-reframe Version: 1.0.2 The skill is a text-processing tool designed for cognitive behavioral therapy (CBT) exercises. The Python scripts (reframe.py and crisis_detector.py) use simple keyword matching to identify cognitive distortions and high-risk mental health signals without any network access, file system manipulation, or use of dangerous functions like eval() or os.system(). The SKILL.md instructions are well-structured, focusing entirely on the stated purpose and including explicit safety boundaries and crisis escalation protocols.
Capability Assessment
Purpose & Capability
The name/description (CBT-based cognitive reframe) matches the included Python modules: a crisis detector and a reframe engine. The files implement pattern detection, reframe suggestions, and crisis escalation, all coherent with the declared purpose. Minor metadata mismatch: skill.json version is 1.0.0 while registry metadata lists 1.0.2 (not a security issue, but an inconsistency).
Instruction Scope
SKILL.md and the scripts specify exactly the expected behavior: listen, detect distortions, provide reframes, and escalate on crisis signals. Crisis-handling is explicit (hotline suggestions and routing to professional help). The runtime instructions and code do not read unrelated files, access environment variables, or send data to external endpoints.
Install Mechanism
This is an instruction-only skill with Python source files and no install spec. Nothing is downloaded or executed from external URLs; no package installs are declared.
Credentials
The skill requests no environment variables, credentials, or config paths. The code does not reference external secrets or other services; required resources are limited to local Python modules.
Persistence & Privilege
always is false and the skill does not request persistent system presence or modify other skills/config. It runs as a normal, user-invoked skill with no elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cognitive-reframe
  3. After installation, invoke the skill by name or use /cognitive-reframe
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
**Changelog for cognitive-reframe v1.0.2** - SKILL.md fully translated from Chinese to English, including all examples, tables, and structure. - No functional logic or technical changes; documentation only. - Alignment with original feature set and safety guidance retained. - Original tone and step-by-step processes preserved in English.
v1.0.1
正式发布版本,基于CBT的认知重构工具,包含危机检测。
v1.0.0
- 首次发布:认知重构(Cognitive Reframe)技能上线,基于CBT帮助用户识别负面思维和尝试平衡视角。 - 提供思维识别、模式分析、重构引导与安全边界功能,适用于日常情绪困扰。 - 内置高风险检测,遇到危机信号自动引导用户求助心理健康专业资源。 - 支持常见认知扭曲类型识别和示例化重构流程,附有自助小行动建议。 - 明确声明非专业治疗工具,仅做日常自助和心理健康提醒。
Metadata
Slug cognitive-reframe
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Cognitive Reframe?

Helps users identify negative thinking patterns and try seeing situations from a more balanced perspective. A CBT-based thought exercise tool for daily self-... It is an AI Agent Skill for Claude Code / OpenClaw, with 178 downloads so far.

How do I install Cognitive Reframe?

Run "/install cognitive-reframe" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cognitive Reframe free?

Yes, Cognitive Reframe is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Cognitive Reframe support?

Cognitive Reframe is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cognitive Reframe?

It is built and maintained by haidong (@harrylabsj); the current version is v1.0.2.

💬 Comments