Skip to content

Add agent skills for the teams CLI - #126

Open
balcsida wants to merge 1 commit into
osodevops:mainfrom
balcsida:feat/agent-skills
Open

balcsida wants to merge 1 commit into
osodevops:mainfrom
balcsida:feat/agent-skills

Conversation

@balcsida

Copy link
Copy Markdown

Adds installable agent skills so Claude Code, Codex and other agents know how to drive teams without reading the whole README. They follow the layout of osodevops/intelligence-layer-skills: one focused skill per workflow surface under skills/<name>/SKILL.md, each with an agents/openai.yaml, and no scripts or assets.

npx skills add osodevops/ms-teams-cli
npx skills add osodevops/ms-teams-cli --skill teams-cli-messaging

What ships:

  • teams-cli-setup: install, delegated sign-in (PKCE and device code, default OSO app, BYO app), profiles, CI and unattended auth, the JSON envelope, the exit code table, pagination, and troubleshooting pointers.
  • teams-cli-messaging: finding ids, reading chats and channels, send/reply/update/react/pin, soft delete and restore, the message get → attachment_items → attachments download pattern, --attach/--image, channel files, and chats.
  • teams-cli-admin: teams, channels, members, tags, apps and tabs, with a read-confirm-write procedure for destructive commands, which have no --yes flag.
  • teams-cli-automation: presence, meetings, activity notifications, change-notification subscriptions with listen, and a polling fallback.
  • README gains an "Agent Skills" section, the docs index links to skills/, CHANGELOG has an Unreleased entry, and docs/attachments-spec.md now names the real skill file instead of a teams-cli skill that never landed.

Verification:

  • Every teams ... line in the skills (116) was checked against the --help output of a binary built from this branch: the subcommand exists and each flag is listed. The skills follow --help where it differs from docs/command-reference.md (chat create --chat-type, no tab update, no subscribe get).
  • npx skills add <local path> --list discovers all four skills.
  • No Rust changes, so no version bump; this is not a release PR.
  • Scope and permission statements come from the repo docs and Graph documentation, not from a live tenant.

…tion

Four installable SKILL.md files under skills/, following the osodevops
skills convention (one focused skill per workflow surface, each with
agents/openai.yaml):

- teams-cli-setup: install, delegated sign-in, profiles, CI auth, the
  JSON envelope, exit codes and pagination
- teams-cli-messaging: find ids, read, send, reply, react, delete and
  restore, attachments and inline images, channel files, chats
- teams-cli-admin: teams, channels, members, tags, apps and tabs, with
  a confirmation procedure for destructive commands
- teams-cli-automation: presence, meetings, activity notifications,
  change-notification subscriptions, the local listener, and polling

Every command line in the skills was checked against the binary's
--help output. README gets an "Agent Skills" section with the
npx skills add install command; the docs index and CHANGELOG link to
the skills, and the attachments spec names the real skill file.
@sionsmith

Copy link
Copy Markdown
Contributor

@balcsida thanks for this - we are reviewing this today.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants