Agent skill

User Thoughts Memory

by sickn33 in sickn33/agentic-awesome-skills

Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

MITAuto-check passedAgent Workflows

Install User Thoughts Memory

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill user-thoughts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills user-thoughts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/user-thoughts .claude/skills/user-thoughts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
user-thoughts
GitHub stars
47k
Used in
1 other repo
Token cost
~2.5k tokens
SKILL.md length
1,121 words
Files
25 (incl. scripts, references, assets)
Skills in repo
1,394
Repo updated
First seen
Licence
MIT

At a glance

Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

  • Works in 6 steps: Decide whether the user message contains… → Write one raw line per independent… → Do not update mdbase directly; wait for… → …
  • Recording architecture, tech-stack or deployment decisions for future sessions
  • SKILL.md covers Overview, When to Use, Language Policy and Core Workflow, plus 13 more sections
  • Calls python

What it does

user-thoughts keeps a project-local memory of what the user has decided, so a later session or a different agent can pick up the intent without asking again. It listens for project rules, constraints, architecture and tech-stack choices, UI and UX direction, backlog items and rejected options, and it also responds to the /user-thoughts and /ustht commands. It records intent alongside normal work: if you ask for a red button, the agent makes the change and notes the preference.

Entries are first written in the user's own words to a raw folder, then a sortin step groups them into an organized mdbase that a show command can display. There are four modes: passive, where only explicit commands run; instant, where thoughts are captured as they appear when INSTANT_STATUS and SKILL_STATUS are on; ignore intervals marked with ignore start and ignore end; and read-only when write tools are missing. The skill ships a runtime template with files for backlog, dev stack, plans, rules and UI details, plus references on commands, edge cases and safety.

When your agent uses it

  • Recording architecture, tech-stack or deployment decisions for future sessions
  • Capturing UI and UX direction, copy standards or design rationale as you state them
  • Keeping a backlog of planned work and rejected options that other agents should inherit
  • Running /user-thoughts or /ustht to sort or show the saved project memory

Example prompts

  • “Remember that this project uses PostgreSQL and that we rejected MongoDB last week.”
  • “Record that all button labels use sentence case and the primary accent color is blue.”
  • “Run /ustht sortin to group the raw notes into the mdbase.”
  • “Show me everything the project memory has stored about our UI direction.”

Requirements

  • Read, write and bash tools available to the agent
  • Pre-approved tools (allowed-tools): read, write, bash

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Decide whether the user message contains project-relevant intent.
  2. Write one raw line per independent thought using - [HH:MM] original text | suggested-dim:dimension.
  3. Do not update mdbase directly; wait for sortin.
  4. Skip ignored messages and ignore intervals.
  5. Keep normal user work moving. Recording should not block task execution.
  6. If one day accumulates more than five raw entries, suggest /ustht sortin.

What it can do on your machine

Read from SKILL.md and the folder at commit 1e53ce2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • read
    • write
    • bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

User Thoughts Memory loads about 2.5k tokens when it runs, and up to ~4.9k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 1,121 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit 1e53ce2, republished under its MIT licence (© sickn33). 1,121 words, ~2,505 tokens.

Download SKILL.mdSave it as .claude/skills/user-thoughts/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
user-thoughts
description
Persist user decisions and project constraints to mdbase across sessions. Trigger on /user-thoughts or /ustht, or when the user discusses architecture, tech stack, rules, UI/UX, or project memory.
allowed-tools
read, write, bash
license
MIT
source
https://github.com/JularDepick/user-thoughts.SKILL
source_repo
JularDepick/user-thoughts.SKILL
source_type
community
date_added
2026-05-31
author
JularDepick
tags
userthoughts, documentation, project-management, mdbase
tools
claude, cursor, gemini
risk
safe
metadata.author
JularDepick

user-thoughts.SKILL

Overview

Across sessions and across agents, project decisions and user constraints are easy to lose. user-thoughts persists those decisions into a project-local mdbase so any future agent can recover the user's intent without re-deriving it from scratch.

The skill records user intent. It does not replace normal task execution. If the user says, "make the button red," the agent should both make the change and record the preference when persistent project memory is useful.

When to Use

Use this skill when the user states or revises:

  • Project rules, constraints, preferences, or requirements.
  • Architecture, tech-stack, data-model, deployment, or workflow decisions.
  • UI/UX direction, copy standards, visual preferences, or design rationale.
  • Backlog items, planned work, rejected options, or decisions that future agents should inherit.
  • A direct command beginning with /user-thoughts or /ustht.

Do not use it for unrelated small talk, transient chatter, or content the user explicitly asks to ignore.

Language Policy

  • All bundled skill files, scripts, templates, and reference docs are written in English.
  • Agent-facing command output should follow the user's current conversation language when the agent can reasonably do so.
  • Raw user thoughts should preserve the user's original wording. Do not translate, summarize, or clean the user's intent unless the user asks for that.

Core Workflow

text
User message -> Agent identifies persistent project intent -> write to #raw/
             -> /ustht sortin groups raw entries into #mdbase/
             -> /ustht mdbase show exposes the organized memory base

Runtime Modes

  • Passive mode: INSTANT_STATUS=off; only explicit skill commands run.
  • Instant mode: INSTANT_STATUS=on and SKILL_STATUS=on; project-relevant user thoughts are written to #raw/ as they appear.
  • Ignore mode: ignore start and ignore end mark a temporary interval that should not be recorded.
  • Read-only mode: if required read/write/bash tools are unavailable, show commands can still work but write commands should explain that the environment cannot persist data.

SKILL_STATUS=off pauses instant capture even when INSTANT_STATUS=on. Ignore intervals are context-local and do not persist across sessions.

Path Definitions

  • @/: the installed user-thoughts/ skill directory.
  • ~/: the current project working directory.
  • #ustht/: ~/.ustht/.
  • #mdbase/: ~/.ustht/mdbase/.
  • #ignored/: ~/.ustht/ignored/.
  • #raw/: ~/.ustht/raw/.
  • #export/: ~/.ustht/export/.

Runtime Directory Layout

text
.ustht/
├── define.ini
├── README.ai.md
├── raw/
│   └── yyyy-mm-dd.md
├── ignored/
│   └── yyyy-mm-dd.md
├── mdbase/
│   ├── backlog.md
│   ├── README.ai.md
│   └── details/
│       ├── rules.md
│       ├── plans.md
│       ├── ui/
│       │   ├── outline.md
│       │   └── details.md
│       ├── dev-stack.md
│       └── general.md
└── export/

Tools and Environment

Required tools:

  • read/write: read and update files under #ustht/.
  • bash: create directories and run bundled scripts.

Optional tool:

  • SubAgent: when available, use it for semantic sortin or resort maintenance that spans many files. Use the main agent directly only when subagents are unavailable.

Bundled Scripts

The scripts/ directory provides small Python helpers for mechanical operations:

ScriptPurposeExample
common.pyShared helpersImported by other scripts
status.pyShow current runtime statepython @/scripts/status.py
init.pyInitialize .ustht/python @/scripts/init.py
show_raw.pyShow unprocessed raw entriespython @/scripts/show_raw.py
show_mdbase.pyShow mdbase index or a dimensionpython @/scripts/show_mdbase.py show --all
sortin.pySoft-maintain raw entries into mdbasepython @/scripts/sortin.py --dry
write_raw.pyAppend one raw thoughtpython @/scripts/write_raw.py "Use REST APIs" --dim dev-stack
toggle.pyToggle skill or instant modepython @/scripts/toggle.py instant on
ignore_ops.pyManage ignored entriespython @/scripts/ignore_ops.py show

resort has no standalone script because it requires semantic review, deduplication, and restructuring by an agent.

define.ini

define.ini stores simple key/value runtime state:

KeyValueMeaning
SKILL_STATUSon or offWhether the skill accepts write operations
INSTANT_STATUSon or offWhether instant capture is enabled
LAST_SORTINyyyy-mm-dd HH:MM or emptyLast soft-maintenance time

Write the file atomically by replacing its complete contents. Do not append partial key/value fragments.

Commands

Commands may use either /user-thoughts or /ustht.

Status and Toggles
  • /ustht init: create .ustht/ and copy templates.
  • /ustht status: show status, raw counts, and dimension counts.
  • /ustht skill: show skill status.
  • /ustht skill on|off: enable or disable writes.
  • /ustht instant: show instant-capture status.
  • /ustht instant on|off: enable or disable instant capture.
Maintenance
  • /ustht sortin [--dry]: append unprocessed raw entries into mdbase.
  • /ustht resort [--dry]: semantically review and reorganize all mdbase content.
Ignore Management
  • /ustht ignore start|end: start or end an ignore interval.
  • /ustht ignore --last: remove the last raw entry and record it in #ignored/.
  • /ustht ignore: same as --last when used as a standalone command.
  • /ustht ignore show: list ignored entries.
  • Any message ending in /ustht ignore or /user-thoughts ignore: ignore that message.
Content Review and Export
  • /ustht raw: show unprocessed raw entries.
  • /ustht mdbase show [--all|--dimension]: show the index, all dimensions, or one dimension.
  • /ustht mdbase export [--all|--dimension]: export mdbase content to #export/.
  • /ustht import <path>: scan markdown files under a safe project-local path and merge project-relevant decisions into mdbase.

Chain commands with &&, for example /ustht skill on && instant on.

Show full SKILL.md (423 more words)Show less

Instant Capture

When instant mode is active:

  1. Decide whether the user message contains project-relevant intent.
  2. Write one raw line per independent thought using - [HH:MM] original text | suggested-dim:dimension.
  3. Do not update mdbase directly; wait for sortin.
  4. Skip ignored messages and ignore intervals.
  5. Keep normal user work moving. Recording should not block task execution.
  6. If one day accumulates more than five raw entries, suggest /ustht sortin.

Sortin and Resort

sortin is soft maintenance:

  1. Read unprocessed #raw/*.md files.
  2. Parse entries and their suggested dimensions.
  3. Append them to matching #mdbase/ files grouped by date.
  4. Mark processed raw files with <!-- processed --> on the first line.
  5. Update LAST_SORTIN and the mdbase index.

resort is hard maintenance:

  1. Review all mdbase files.
  2. Deduplicate overlapping records.
  3. Move entries into better dimensions when justified by the user's own wording.
  4. Mark deprecated dimensions instead of deleting them unless the user explicitly requests deletion.
  5. Preserve provenance and user wording.

Best Practices

  • Record explicit user decisions faithfully.
  • Do not over-infer. Store only what the user said or what follows directly from it.
  • Preserve original wording, including negations, numbers, links, constraints, and tradeoffs.
  • Split one message into multiple records when it contains independent decisions.
  • Resolve conflicts by treating the newest user statement as current while preserving the older record as historical context.
  • Put unmatched project-relevant items in general.md instead of inventing too many dimensions.
  • Do not record unrelated conversation.

Limitations

  • The skill records intent; it does not validate whether the user's idea is correct, feasible, secure, or internally consistent.
  • Dimension assignment depends on agent judgment and may need user correction through resort.
  • Ignore intervals are context-local and do not persist across sessions.
  • .ustht/ can contain sensitive information. The skill does not redact content; users must use ignore commands or repository hygiene to manage sensitive data.
  • The workflow is not file-lock based. In multi-agent environments, agents must coordinate to avoid conflicting writes.

Safety Rules

  • Keep all runtime writes inside #ustht/.
  • Validate dimension names: lowercase letters, digits, hyphens, and / subdirectories only; no .., backslashes, spaces, absolute paths, or reserved names.
  • Do not execute user-provided shell commands.
  • Do not recursively copy directories with shell commands during initialization; copy known template files safely.
  • Treat <!-- processed --> as meaningful only when it is the first line of a raw file.
  • Never silently delete dimension files; mark deprecated content unless the user explicitly asks for deletion.

More detail is available in references/safety.md, references/sortin.md, references/commands.md, and references/edge-cases.md.

None. This skill is intentionally focused on project-local user intent persistence.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts, references, assets) in skills/user-thoughts of sickn33/agentic-awesome-skills.

  • SKILL.md
  • assets/Runtime-Template/README.ai.md
  • assets/Runtime-Template/define.ini
  • assets/Runtime-Template/mdbase/README.ai.md
  • assets/Runtime-Template/mdbase/backlog.md
  • assets/Runtime-Template/mdbase/details/dev-stack.md
  • assets/Runtime-Template/mdbase/details/general.md
  • assets/Runtime-Template/mdbase/details/plans.md
  • assets/Runtime-Template/mdbase/details/rules.md
  • assets/Runtime-Template/mdbase/details/ui/details.md
  • assets/Runtime-Template/mdbase/details/ui/outline.md
  • references/commands.md
  • references/edge-cases.md
  • references/safety.md
  • references/sortin.md
  • … and 10 more

Open the folder on GitHubat commit 1e53ce2

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

User Thoughts Memory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

User Thoughts Memory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
User Thoughts Memory this skillsickn33/agentic-awesome-skills47k1 repos~2.5kAutomated safety check: PassMIT
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence
Planning with FilesOthmanAdi/planning-with-files27k—~2.9kAutomated safety check: PassMIT
Planning With FilesOthmanAdi/planning-with-files27k—~3kAutomated safety check: PassMIT
Harness Engineering10xChengTu/harness-engineering1021 repos~1kAutomated safety check: PassNone
Planning with Files for KiroOthmanAdi/planning-with-files27k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check: notes
  • Planning with Files

    OthmanAdi/planning-with-files

    Keeps a task plan, findings and progress log in markdown files on disk so long agent tasks survive context resets, with Gemini hooks and helper scripts.

    27k GitHub stars~2.9k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Planning With Files

    OthmanAdi/planning-with-files

    Keeps a task plan, findings and progress log as Markdown files in the project so long multi-step agent work survives context resets.

    27k GitHub stars~3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Harness Engineering

    10xChengTu/harness-engineering

    Set up and improve harness engineering (AGENTS.md, docs/, lint rules, eval systems, project-level prompt engineering) for AI-agent-friendly codebases.

    102 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed
  • Planning with Files for Kiro

    OthmanAdi/planning-with-files

    Keeps task_plan.md, findings.md and progress.md on disk as the agent's working memory for multi-step work, wired into Kiro steering, with no hooks.

    27k GitHub stars~2.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • CPR Compress

    EliaAlberti/cpr-compress-preserve-resume

    Saves the current session as a searchable log with a curated summary and the raw transcript, so a later session can resume from it.

    513 GitHub stars~1.1k tokensUpdated 28 days ago
    Agent WorkflowsAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,394 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Content Creator

    sickn33/agentic-awesome-skills

    Drafts and reviews audience-specific content from supplied brand examples, with local scripts for brand voice and SEO diagnostics, channel templates and a content calendar.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed

Categories

Questions about User Thoughts Memory

What does User Thoughts Memory do?

Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent. user-thoughts keeps a project-local memory of what the user has decided, so a later session or a different agent can pick up the intent without asking again. It listens for project rules, constraints, architecture and tech-stack choices, UI and UX direction, backlog items and rejected options, and it also responds to the /user-thoughts and /ustht commands.

When should I use User Thoughts Memory?

User Thoughts Memory fits situations like: recording architecture, tech-stack or deployment decisions for future sessions; capturing UI and UX direction, copy standards or design rationale as you state them; keeping a backlog of planned work and rejected options that other agents should inherit; running /user-thoughts or /ustht to sort or show the saved project memory.

How do I install User Thoughts Memory in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill user-thoughts -a claude-code`. Or copy the skill folder (skills/user-thoughts in sickn33/agentic-awesome-skills) into .claude/skills/user-thoughts in your project. Claude Code loads it when a task matches its description.

How do I install User Thoughts Memory in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill user-thoughts -a codex`. Or copy the skill folder (skills/user-thoughts in sickn33/agentic-awesome-skills) into .agents/skills/user-thoughts in your project. Codex loads it when a task matches its description.

Can I use User Thoughts Memory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill user-thoughts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/user-thoughts, .gemini/skills/user-thoughts, .github/skills/user-thoughts and .opencode/skills/user-thoughts in your project.

What does User Thoughts Memory need to run?

Going by SKILL.md and its folder, User Thoughts Memory needs the command-line tools its instructions call (python). Our summary lists: Read, write and bash tools available to the agent. Its frontmatter pre-approves these tools: read, write, bash.

Does User Thoughts Memory access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is User Thoughts Memory safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does User Thoughts Memory use?

User Thoughts Memory is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does User Thoughts Memory use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.4k tokens, read only when the agent opens those files.

What are the alternatives to User Thoughts Memory?

Skills that share tags, products or a category with User Thoughts Memory: Memori Long-Term Memory (MemoriLabs/Memori, 17k stars), Planning with Files (OthmanAdi/planning-with-files, 27k stars), Planning With Files (OthmanAdi/planning-with-files, 27k stars) and Harness Engineering (10xChengTu/harness-engineering, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains User Thoughts Memory?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,304 GitHub stars. The repository holds 1,394 skills in this directory. The repository was last updated on October 6, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.