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 #
- Tangled: https://tangled.org/
- Tangled docs: https://docs.tangled.org/
- Quick start: https://docs.tangled.org/quick-start-guide
- Webhooks: https://docs.tangled.org/webhooks
tangCLI: https://github.com/onevcat/tang
License #
MIT, unless a future maintainer chooses a different license file for this repository.