Platform-neutral Agent Skill for working with Tangled.org tangled.org/homebodify.tngl.sh/tangled-skill
README.md

Tangled Agent Skill #

A platform-neutral Agent Skill for working with Tangled.org, the decentralized Git code hosting and collaboration platform built on AT Protocol.

This skill teaches Agent Skills-compatible AI coding agents how to use Tangled for repository hosting, Git operations, issues, pull requests, CI/CD workflows, webhooks, and AT Protocol-related troubleshooting.

What this skill covers #

  • Tangled Git clone / push / pull / migration / mirroring workflows
  • GitHub-to-Tangled concept and command mapping
  • Tangled CLI usage patterns (tang, tng, tangled)
  • Issue and pull request workflows
  • SSH key and authentication troubleshooting
  • AT Protocol basics: handles, DIDs, PDS, AppView, knots
  • Spindles CI/CD workflows
  • Tangled webhooks

What this skill does not include #

  • No MCP dependency
  • No embedded credentials or API keys
  • No private SSH keys
  • No executable scripts

It is intentionally written as Markdown-only skill documentation so it can be reused across Agent Skills-compatible and other skill-aware agent environments.

Structure #

tangled/
├── SKILL.md
└── references/
    ├── atproto-troubleshooting.md
    ├── cli.md
    ├── git-ops.md
    ├── github-mapping.md
    ├── issues-prs.md
    └── knots-spindles-webhooks.md

Installation #

Copy the tangled/ directory into a supported skills directory.

For global skill-aware agent environments:

mkdir -p ~/.agents/skills
cp -R tangled ~/.agents/skills/tangled

For project-local usage:

mkdir -p .agents/skills
cp -R tangled .agents/skills/tangled

Then start a new agent session so the skill metadata can be discovered.

Usage examples #

Ask your agent things like:

  • "Clone this Tangled repo."
  • "Push this project to Tangled."
  • "Mirror this GitHub repo to Tangled."
  • "Create a Tangled issue for this bug."
  • "Open a Tangled pull request from this branch."
  • "Set up a Spindle workflow."
  • "Why is Tangled SSH push failing?"

Primary references #

License #

MIT, unless a future maintainer chooses a different license file for this repository.