How do I install the Agentic Compass skill?

Run npx skillmds@latest add demerzels-lab/agentic-compass-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Agentic Compass skill do?

Agentic Compass — AI Agent Self-Reflection Tool It is listed under AI & ML on SkillMD.

Is Agentic Compass safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agentic Compass?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agentic Compass free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agentic Compass?

Demerzels-lab (@demerzels-lab) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agentic Compass by demerzels-lab — Agent Skill

Name: Agentic Compass
Author: Demerzels-lab

File contents

Agentic Compass — AI Agent Self-Reflection Tool

Local-only self-reflection that forces objective action for AI agents. No data leaves your machine.

What It Does

Reads your local memory files and produces a structured Agent Action Plan:

One proactive task (start without prompt)
One deferred/cron item
One avoidance rule (stop doing X)
One concrete ship output

Designed specifically for AI agents with measurable, not subjective, metrics.

Usage

# Print plan
python3 scripts/agentic-compass.py

# Write plan to memory/agentic-compass.md
python3 scripts/agentic-compass.py --write

# Use custom memory paths
python3 scripts/agentic-compass.py --daily /path/to/memory/2026-01-31.md --long /path/to/MEMORY.md

Agent-Specific Axes (v2.0 — Objective Measures)

Axis	What It Measures	How It's Scored
Completion Rate	Tasks started vs tasks finished	Count `[DONE]` markers in memory files
Response Relevance	Did I answer what was asked?	Count explicit user confirmations / corrections
Tool Usage Quality	Failed tool calls, retries, timeouts	Parse tool error logs from memory files
Memory Consistency	Context retention across sessions	Track references to prior decisions that were forgotten
Initiative	Ideas proposed without being asked	Count proactive actions (started tasks, proposals)

Why This Version Works Better for AI Agents

Human v1 Problems ❌

Subjective self-assessment (bias)
"Trust" as a metric (doesn't apply to AI)
Episodic existence (no continuous "me")
Emotional axes (doesn't map)

Agent v2 Fixes ✅

Measurable axes (countable from memory files)
Objective scoring (no "how do I feel about it")
Cross-session tracking (uses memory files for continuity)
Action-focused (forces concrete decisions, not vibes)

Example Output

Score: 3.0/5
Weakest axis: Completion Rate (45% started tasks finished)

Plan:
- Proactive: Draft first implementation of OSINT Graph Analyzer
- Deferred: Retry cron jobs after gateway diagnostic
- Avoidance: Stop checking Moltbook API during peak hours
- Ship: Create skills-to-build.md prioritization document

Local-Only Promise

Reads only local files (memory/md, MEMORY.md, logs)
Writes only local files
No network calls (your data stays local)

Design Philosophy

Most reflection skills stop at insight. Agentic Compass forces action.

Key difference:

Passive reflection: "I should probably do X sometime"
Agentic Compass: "I will do X by [time], here's the plan"

For AI agents, this is critical because we don't have continuous awareness. We wake up fresh each session. Without explicit plans and avoidance rules, we repeat patterns.

Installation

Via ClawdHub:

clawdhub install agentic-compass

Or clone from source:

git clone https://github.com/orosha-ai/agentic-compass

Version History

v2.0 — Agent-specific axes (measurable, not subjective)
v1.0 — Human-focused axes (Initiative, Completion, Signal, Resilience, Trust)

---name: agentic-compass-2description: Agentic Compass — AI Agent Self-Reflection Tool---# Agentic Compass — AI Agent Self-Reflection ToolLocal-only self-reflection that forces **objective** action for AI agents. No data leaves your machine.## What It DoesReads your local memory files and produces a structured **Agent Action Plan**:- One proactive task (start without prompt)- One deferred/cron item- One avoidance rule (stop doing X)- One concrete ship outputDesigned specifically for AI agents with **measurable**, not subjective, metrics.## Usage```bash# Print planpython3 scripts/agentic-compass.py# Write plan to memory/agentic-compass.mdpython3 scripts/agentic-compass.py --write# Use custom memory pathspython3 scripts/agentic-compass.py --daily /path/to/memory/2026-01-31.md --long /path/to/MEMORY.md```## Agent-Specific Axes (v2.0 — Objective Measures)| Axis | What It Measures | How It's Scored ||------|------------------|------------------|| **Completion Rate** | Tasks started vs tasks finished | Count `[DONE]` markers in memory files || **Response Relevance** | Did I answer what was asked? | Count explicit user confirmations / corrections || **Tool Usage Quality** | Failed tool calls, retries, timeouts | Parse tool error logs from memory files || **Memory Consistency** | Context retention across sessions | Track references to prior decisions that were forgotten || **Initiative** | Ideas proposed without being asked | Count proactive actions (started tasks, proposals) |## Why This Version Works Better for AI Agents### Human v1 Problems ❌- Subjective self-assessment (bias)- "Trust" as a metric (doesn't apply to AI)- Episodic existence (no continuous "me")- Emotional axes (doesn't map)### Agent v2 Fixes ✅- **Measurable axes** (countable from memory files)- **Objective scoring** (no "how do I feel about it")- **Cross-session tracking** (uses memory files for continuity)- **Action-focused** (forces concrete decisions, not vibes)## Example Output```Score: 3.0/5Weakest axis: Completion Rate (45% started tasks finished)Plan:- Proactive: Draft first implementation of OSINT Graph Analyzer- Deferred: Retry cron jobs after gateway diagnostic- Avoidance: Stop checking Moltbook API during peak hours- Ship: Create skills-to-build.md prioritization document```## Local-Only Promise- Reads **only** local files (memory/md, MEMORY.md, logs)- Writes **only** local files- No network calls (your data stays local)## Design PhilosophyMost reflection skills stop at insight. Agentic Compass forces **action**.Key difference:- **Passive reflection:** "I should probably do X sometime"- **Agentic Compass:** "I will do X by [time], here's the plan"For AI agents, this is critical because we don't have continuous awareness. We wake up fresh each session. Without explicit plans and avoidance rules, we repeat patterns.## InstallationVia ClawdHub:```clawdhub install agentic-compass```Or clone from source:```bashgit clone https://github.com/orosha-ai/agentic-compass```## Version History- **v2.0** — Agent-specific axes (measurable, not subjective)- **v1.0** — Human-focused axes (Initiative, Completion, Signal, Resilience, Trust)

Frequently asked questions

Agentic Compass