SkillAgentSearch skills...

hivemind-goals

Create, track and update team goals via the Deeplake virtual filesystem at memory/goal/

Install / Use

npx skills add activeloopai/hivemind --skill hivemind-goals

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

89/100

Supported Platforms

Universal

Tags

Our assessment of hivemind-goals

hivemind-goals scores 89/100 on our quality scale, 510th of 1,153 Content & Media skills we index (top 45%).

Its SKILL.md is 7.4 KB long, well organised into 21 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.

With 1,620 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
12/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so hivemind-goals is actively maintained.
  • Our last check on 2026-10-31 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk โ€” read a skill before letting an agent act on it.

hivemind-goals compared with similar skills

All 4 of these similar skills score higher than hivemind-goals; compare them before choosing.

SkillScoreStarsUpdatedFormat
hivemind-goals (this skill)by activeloopai891.6k2mo agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install hivemind-goals?
Run npx skills add activeloopai/hivemind --skill hivemind-goals. The install tabs above show the steps for each supported agent.
Which AI agents does hivemind-goals work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is hivemind-goals safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is hivemind-goals still maintained?
The repository was last updated about 2 months ago, so hivemind-goals is actively maintained.

name: hivemind-goals description: Create, track and update team goals via the Deeplake virtual filesystem at memory/goal/. Use whenever the user mentions a goal, objective, target, milestone, or asks to track progress on something measurable. ALSO use when the user says "task", "todo", "work item", "remind me to", "fix X", or any actionable work item โ€” the goal system replaced the legacy hivemind tasks CLI and now covers both objectives and tasks. allowed-tools: Read Bash

Hivemind Goals

Track goals as Markdown files inside the Deeplake virtual filesystem. Each file is one row in a dedicated team-shared table โ€” the path encodes the structural metadata, the file body holds the human-readable description.

When to use this skill

Activate when the user expresses any of:

  • "I want to track X / aim for X / track my progress on Y"
  • "add a goal", "what are my goals?"
  • "mark this as done", "close that goal"
  • "shipping X by Friday", "5 PRs this week", any measurable target
  • "create a task", "add a todo", "remind me to fix X", any work item (the goals system absorbs the old hivemind tasks CLI โ€” there is no separate task store)

For "list my goals" โ†’ run ls ~/.deeplake/memory/goal/<userName>/opened/ and ls ~/.deeplake/memory/goal/<userName>/in_progress/. If empty, ask the user if they want to create one.

Path conventions (LEARN THESE)

~/.deeplake/memory/goal/<owner>/<status>/<goal_id>.md
  • <owner> โ€” user identifier (use the userName from hivemind whoami or the credentials)
  • <status> โ€” one of opened, in_progress, closed
  • <goal_id> โ€” UUIDv4 you generate at create time

Path encoding is the source of truth. The owner, status, and goal_id come from the path โ€” NOT from the file body. Do NOT write owner/status/goal_id inside the file content.

File body format

Goal file body โ€” plain markdown, free form:

ship the goals-graph feature

Notes: route every write through the VFS, no separate CLI.
Due: 2026-05-30.

The first line is the human-readable label (what goal list and the SessionStart banner show). Anything else is free notes.

Operations

1. Create a new goal

When the user expresses a new goal:

  1. Get the current owner with hivemind whoami (use the userName, e.g. emanuele.fenocchi).
  2. Generate a UUIDv4: uuidgen (do NOT use node -e โ€” Node is not available under the VFS path).
  3. Write the goal file via Bash (Write / Edit are denied on memory paths; only Bash is intercepted and routed to SQL):
    cat > ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md <<'EOF'
    <goal description here, multiple lines OK>
    EOF
    
    For a single-line goal, echo '<text>' > ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md is equivalent.
  4. Respond to the user that the goal is created.

1a. Capture a task for later (with resumable context)

Use this when the user parks a tangential task mid-session โ€” "save this for later", "remind me to โ€ฆ", "don't let me forget โ€ฆ", "let's do X later", "capture this in Hivemind". The value is NOT the one-liner โ€” it's storing enough context to resume cold in a future session without the user re-explaining anything.

Write it via the CLI (not the VFS heredoc) so the row is tagged agent: capture, which separates parked side-tasks from hand-made goals:

hivemind goal add --agent capture "Add rate-limiting to the webhook handler

Start here: add a per-IP token bucket on the handler entry path
Files: src/webhook/handler.ts:120-160, src/webhook/limits.ts
Branch: feat/webhook-hardening
Run: pnpm test webhook
Why: bursty clients hammer the endpoint; agreed to defer until the retry-backoff work lands"
  • Line 1 is the label โ€” keep it short; it's what goal list and the SessionStart banner show.
  • Fill Start here / Files / Branch / Run / Why from the live conversation โ€” you already know the files you just touched and the branch. Include only the lines you can fill; omit the rest. Start here: is the most important โ€” the concrete first action.
  • Pass the whole package as one double-quoted argument (the newlines are preserved into the stored body).
  • Confirm to the user: the label + that it'll resume cleanly next session.

1b. Resume a parked task (automatic context transfer)

When the user says "let's work on that task / that goal", "let's start the <X> task", or "pick up the parked <X>", pull its stored context back into the session and continue โ€” the user should NOT have to re-explain anything.

  1. Find it: hivemind goal list --mine and match the user's reference to a goal_id (by label / topic). If ambiguous, show the candidates and ask which one.
  2. Transfer the context: hivemind goal get <goal_id> prints the full package (Start here / Files / Branch / Run / Why). Read it as your working context โ€” goal list only shows the first line, so always use goal get for the full body.
  3. Flip to in_progress: mv ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md ~/.deeplake/memory/goal/<owner>/in_progress/<uuid>.md
  4. Act on it: open the Files:, switch to the Branch: if given, and begin from Start here:. You are now resumed โ€” continue as if the context was never lost. Close it (section 5) when the work is done.

2. List goals

ls ~/.deeplake/memory/goal/<owner>/opened/
ls ~/.deeplake/memory/goal/<owner>/in_progress/

Then cat each <uuid>.md to read the body.

3. Edit a goal description

# Read the existing body, then overwrite via Bash heredoc. Edit / Write
# tools are denied on memory paths in claude-code (the hook can only
# rewrite Bash). The VFS handles version-bumping โ€” every overwrite
# produces a fresh row in the hivemind_goals table.
cat ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md   # read current
cat > ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md <<'EOF'
<new body here>
EOF

4. Move a goal to in_progress

mv ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md ~/.deeplake/memory/goal/<owner>/in_progress/<uuid>.md

mv between status folders is an atomic version-bump. The file body carries over unchanged.

5. Close a goal

Two equivalent ways:

# Explicit mv to closed (recommended โ€” clearest intent)
mv ~/.deeplake/memory/goal/<owner>/in_progress/<uuid>.md ~/.deeplake/memory/goal/<owner>/closed/<uuid>.md

# Or: rm (the VFS interprets rm on a goal path as a soft-close)
rm ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md

Important: rm does NOT actually delete the goal. It is a soft-close โ€” the VFS writes a new version with status=closed. The goal remains in the team-shared table for audit. There is no hard-delete in v1.

6. Reassign a goal (transfer ownership)

mv ~/.deeplake/memory/goal/<old-owner>/<status>/<uuid>.md ~/.deeplake/memory/goal/<new-owner>/<status>/<uuid>.md

Goal ownership lives in the path; the file body carries over unchanged.

Constraints โ€” DO NOT do these

  • Do NOT put owner, status, or goal_id inside the file body. The path is the source of truth โ€” duplicating in the body causes drift.
  • Do NOT use status values other than opened, in_progress, closed.
  • Do NOT rename the goal_id (the UUID in the filename) via mv. The VFS rejects goal_id renames.

Team visibility

Every write goes to a team-shared table on Deeplake (hivemind_goals). Other team members see your goals in their SessionStart context and via direct ls / cat on the same paths in their own VFS. No explicit sharing step needed.

Related Skills

View on GitHub
GitHub Stars1.6k
CategoryContent
Updated2mo ago
Forks108

Languages

TypeScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

No cautions
hivemind-goals โ€” Universal Skill: Install & Safety Check | SkillAgent