OpenParable
Skip to content
← Back to skills

Knowledge Organize

Productivity
knowledge-organize

Knowledge Organize is an Agent Skill for productivity published in the evolution-foundation/evo-nexus repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create, move, reorder, or link learning units and documents in the Knowledge base. Use when the user wants to structure content ('create unit Module 3', 'move these docs to lesson 2', 'reorder lessons by logical sequence', 'link doc X to unit Y').

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/evolution-foundation/evo-nexus/blob/HEAD/.claude/skills/knowledge-organize/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/knowledge-organize, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

knowledge-organize

Group: Curation. Units: create, move, reorder, link documents.

When to trigger

  • "Create unit 'Module 3'"
  • "Reorder lessons by logical sequence"
  • "Move these documents to unit X"
  • "Link doc Y to lesson 2"

Arguments

NameTypeRequiredDescription
actionstryescreate | move | reorder | link | update
connectionstrnoDefaults to first ready
(action-specific args below)

Actions

create

Args: space_id (or space slug), slug, title, sequence_idx (optional), description, prerequisites (list uuids), metadata (dict).

from dashboard.backend.sdk_client import evo

unit = evo.post(
    "/api/knowledge/v1/units",
    {"space_id": space_id, "slug": slug, "title": title, ...},
    headers={"X-Knowledge-Connection": connection},
)

move (document → unit)

Args: document_id, unit_id (null to unlink).

evo.patch(
    f"/api/knowledge/v1/documents/{document_id}",
    {"unit_id": unit_id},
    headers={"X-Knowledge-Connection": connection},
)

reorder (units within space)

Args: space_id, ordered_ids (list of unit uuids in desired order).

evo.post(
    "/api/knowledge/v1/units/reorder",
    {"space_id": space_id, "ordered_ids": ordered_ids},
    headers={"X-Knowledge-Connection": connection},
)

link (N documents → 1 unit)

Args: unit_id, document_ids (list).

for doc_id in document_ids:
    evo.patch(
        f"/api/knowledge/v1/documents/{doc_id}",
        {"unit_id": unit_id},
        headers={"X-Knowledge-Connection": connection},
    )

update (unit metadata)

Args: unit_id, title, description, sequence_idx, prerequisites, metadata.

evo.patch(
    f"/api/knowledge/v1/units/{unit_id}",
    {"title": title, "description": description, ...},
    headers={"X-Knowledge-Connection": connection},
)

Output

Confirmation per action:

✓ Unit created: {title}
  slug: {slug}
  space: {space}
  sequence_idx: {N}
  id: {uuid}

For reorder:

✓ Reordered {N} units in space {space}:
  1. {title_1}
  2. {title_2}
  ...

Actionable failures

  • Invalid action → list valid actions
  • unit_id not found → "Unit not found. Use knowledge-browse scope=units."
  • Duplicate sequence_idx → suggest reorder
  • Insufficient permission → "Token lacks write scope"