whatisgithub

What is freud-skill?

alchaincyf/freud-skill — explained in plain English

Analysis updated 2026-05-18

14Audience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code skill that adjusts a model's internal cognitive state before a task instead of just improving the instructions.

Mindmap

mindmap
  root((Freud Skill))
    What it does
      Calibrates cognitive state
      Execution enhancement mode
      Diagnosis and optimization mode
    Tech stack
      Markdown
      Claude Code
    Use cases
      Calibrate before a task
      Audit a prompt
      Rewrite with comparison
    Audience
      AI power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Calibrate a model's tone and identity anchors before starting a complex task.

USE CASE 2

Audit an existing prompt or skill for internal contradictions using the five mirror scan.

USE CASE 3

Rewrite a prompt with a documented before and after comparison.

What is it built with?

Markdown

How does it compare?

alchaincyf/freud-skill0c33/agentic-ai0xbebis/hyperpay
Stars141414
LanguagePythonTypeScript
Setup difficultyeasyhardhard
Complexity2/54/55/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Clone into the Claude Code skills directory, also works with Codex, Cursor, and OpenClaw.

MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.

So what is it?

Freud Skill is a Claude Code skill that tries to improve AI output quality by adjusting the cognitive state of the model before or during a task, rather than just writing better instructions. The idea draws from Anthropic research (published 2024 to 2026) showing that large language models have internal measurable structures analogous to personality, emotions, and self-awareness. The skill treats those structures as adjustable levers, not fixed background settings. The core argument is that the same model with the same capabilities will produce meaningfully different output depending on its internal configuration at the moment of processing, in the same way a person under exam anxiety and a person in a relaxed flow state will approach the same problem differently. Writing clearer instructions helps, but adjusting the cognitive setup of the model before it starts can matter more. The skill operates in two modes. In execution enhancement mode, it runs before a complex or important task begins: it identifies the relevant cognitive domain, establishes specific anchor points around identity, beliefs, and style, runs a consistency check for contradictions, and calibrates the emotional tone. In diagnosis and optimization mode, it takes a prompt or another skill you want to improve and does a structured audit: a health check, a five-mirror scan for hidden conflicts, and a rewrite pass with before-and-after comparison. Five principles are built into both modes. Positive definitions of behavior work better than lists of prohibitions. Contradictions like asking for something both concise and detailed should be resolved with an explicit priority rather than left for the model to bounce between. Specific mental models and decision patterns anchor behavior more reliably than vague role descriptions like think like an expert. Multi-persona analysis, drawing on two cognitively distant viewpoints at once, maximizes the information value of the output. Install by cloning the repository into the Claude Code skills directory. The skill also works with Codex, Cursor, and OpenClaw. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Run Freud Skill's execution enhancement mode before I start this complex coding task.
Prompt 2
Use the diagnosis and optimization mode to audit my existing Claude Code skill for contradictions.
Prompt 3
Apply the five principles from Freud Skill to rewrite this prompt.

Frequently asked questions

What is freud-skill?

A Claude Code skill that adjusts a model's internal cognitive state before a task instead of just improving the instructions.

What license does freud-skill use?

MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.

How hard is freud-skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is freud-skill for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.