Add team source

Skill thettwe/nyann/skills/add-team-source

Nyann (ငြမ်း) is Burmese for scaffolding. Nyann is a Claude Code plugin that sets up and maintains project governance.

Install

npx -y skills add thettwe/nyann --skill add-team-source

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Register a git URL as a team-profile source so nyann can periodically sync and expose its profiles under a namespace. TRIGGER when the user says "add a team profile source", "register a team profile source", "set up team profiles from <url>", "wire up our team's shared profiles at <repo>", "add profile source named X at <url>", "install team profiles from <git repo>", "/nyann:add-team-source". Do NOT trigger on "sync team profiles now" (that's `sync-team-profiles` — the pull operation). Do NOT trigger on "save my setup as a profile" (that's `learn-profile` — writes to user root, not a team source). Do NOT trigger on generic "add a repo" or "add a remote" — those are git operations unrelated to profile distribution.

SKILL.md

2.7 KB, as published. Nobody here has run it

add-team-source

Wraps bin/add-team-source.sh. Updates ~/.claude/nyann/config.json to declare a new team-profile source. Idempotent — passing the same --name updates the entry in place.

1. Collect inputs

--name <id> — required. Short slug, ^[a-z0-9][a-z0-9-]*$. Will also become the namespace prefix for team profiles (e.g. platform-team/base when name is platform-team). When the user gives a name with spaces or caps, propose a slug and confirm.
--url <git-url> — required. Any URL git can clone (https://, git@, file:// for testing).
--ref <branch-or-tag> — default main. Override when the team pins a specific branch or tag.
--interval <hours> — default 24. How often sync-team-profiles will re-pull from this source without --force. Decrease only when the user says "we update these often" or similar.

2. Pre-flight

Config path defaults to ~/.claude/nyann/config.json. Override only when the user explicitly names a different user root.
The backend upserts on --name collision. Warn the user if they're replacing an existing source with a different URL — that's usually unintentional. Read current config first if unsure.

3. Invoke

bin/add-team-source.sh \
  --name <id> \
  --url <git-url> \
  [--ref <branch>] \
  [--interval <hours>] \
  [--user-root <dir>]

Exit 0 on success; config path is logged to stderr.

4. Report back

Name, URL, ref, interval.
Tell the user "Run /nyann:sync-team-profiles (or ask 'sync my team profiles') to actually pull them". add-team-source only registers — the pull is a separate operation on purpose (no surprise network calls here).

When to hand off

"Now pull them" → sync-team-profiles skill.
"Apply a team profile to this repo" → bootstrap-project with the namespaced profile name (e.g. platform-team/base).
"Show what the team profile does" → inspect-profile with the namespaced name.