agentleFS
yogsoth-aiyogsoth-ai/knowledge-structuring/skills/wiki-add-edge/SKILL.md

wiki-add-edge

Skill2 starsChanged 6 months agoApache-2.0View on GitHub

SOP wrapping vault_add_edge — create a typed relationship between two vault pages.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Create a typed edge between two pages in the knowledge graph.

    line 10
  2. Distinctive:

    Do NOT create edges to non-existent pages.

    line 17
  3. Distinctive:

    Verify both source and target files exist

    line 35
  4. Distinctive:

    If duplicate rejected, this is expected — the relationship already exists

    line 38
  5. Very specific:

    Inline wikilink: Ensure the source page body contains [[dir/slug]] pointing to the target (dir/slug = target path minus .md).

    line 39

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Wiki Add Edge

Create a typed edge between two pages in the knowledge graph.

HARD-GATE

<HARD-GATE> Both source and target paths must reference existing files in the vault. Edge type must be one of the 10 defined types in _schema.md. Do NOT create edges to non-existent pages. </HARD-GATE>

Tool

vault_add_edge

Parameters

ParamRequiredDescription
sourceyesSource page path (e.g., "concepts/transformer.md")
targetyesTarget page path (e.g., "concepts/attention.md")
edge_typeyesOne of: component_of, instance_of, supported_by, contradicts, supersedes, derived_from, addresses, raises, failed_for, related_to
weightnoEdge weight 0.0-1.0 (default 1.0)

Protocol

  1. Verify both source and target files exist
  2. Select appropriate edge_type based on the semantic relationship
  3. Call vault_add_edge
  4. If duplicate rejected, this is expected — the relationship already exists
  5. Inline wikilink: Ensure the source page body contains [[dir/slug]] pointing to the target (dir/slug = target path minus .md). Place at a semantically relevant location. If already present, skip. If no suitable location, append a sentence containing the wikilink at end of body.
  6. Return result to calling tactic

Edge Type Selection Guide

RelationshipEdge Type
A is part of Bcomponent_of
A is an example of Binstance_of
A provides evidence for Bsupported_by
A conflicts with Bcontradicts
A replaces Bsupersedes
A was built from Bderived_from
A answers/solves Baddresses
A creates/implies B (question)raises
A didn't work for Bfailed_for
A is related to B (weak)related_to

Yield

Returns: { success: boolean, edge_type: string, edge_count: number }

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.