Index of every page on this site: llms.txt
All skills
composiohq avatar

/repo-guidance

@85dab73
by Composiocomposiohq/composio31k stars
4,962
Run it yourself

Navigate the Composio SDK monorepo, branch and PR workflow, repo layout, generated-file boundaries, changesets, and shared maintenance rules. Use when work spans multiple packages, when deciding where code belongs, when preparing a PR, or when the user asks about repository conventions rather than a specific SDK implementation.

Use this Skill: https://skilld.dev/gh/composiohq/composio/repo-guidance

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesrepository-workflow.md

≈584 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Repository Workflow

Branches

  • Default active base: next.
  • Create feature branches from origin/next unless the user names another base.
  • Target PRs at next for SDK and docs work.

Layout

  • ts/: TypeScript SDK, providers, CLI, examples, and runtime E2E tests.
  • python/: Python SDK, providers, tests, nox sessions, and release scripts.
  • docs/: Fumadocs site, generated API/toolkit data, changelogs, and docs automation.
  • .agents/skills/: canonical local skill tree.
  • docs/agent-guidance/: neutral docs-agent context and workflow prompts.
  • docs/decisions/: neutral docs decisions and plans.

Tooling

Use mise install for Node, Bun, pnpm, Python, and uv. pnpm is managed through mise.

Common root commands:

pnpm install
pnpm build
pnpm build:packages
pnpm lint
pnpm typecheck
pnpm test
pnpm test:e2e
pnpm test:e2e:cli
bun run validate:agent-skills

Python commands run from python/:

make env
source .venv/bin/activate
make fmt
make chk
make tst
make snt
make build

Changesets

  • Public SDK behavior changes need a Changesets note for each affected TypeScript package and/or the private @composio/python-sdk marker. Python core and supported providers share one stable release train.
  • @composio/cli is ignored by Changesets. Never target it in a changeset while it remains ignored; use the cli-release skill for beta builds and stable promotion.
  • Repo guidance, docs-only, tests-only, internal validation and CLI-only changes do not require an SDK note. Explicit behavior exemptions need a meaningful <!-- sdk-release-note-exempt: meaningful reason of at least 20 characters --> comment in the PR body.
  • Stable and beta SDKs use SDK release on protected next: a member issue request, one release PR that a repository writer approves and a person merges, and a tag run that publishes the PR-built candidates. Requesters may approve only with repository admin permission at release time; the PR author remains excluded. Recover with Re-run failed jobs. Read ts/docs/internal/release.md before operating it.

Generated And Vendor Files

  • Do not edit ts/vendor/; those trees are read-only references.
  • Keep generated outputs owned by their generator.
  • For generated client bumps, verify the package version resolves before updating pins.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warningtoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    The skill provides workflow guidance and repository documentation for the Composio SDK monorepo. It contains standard development commands and environment setup instructions without any malicious patterns.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

Signed by skilld at 85dab73. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 5 months ago

README badge

README badge for composiohq/composio/repo-guidance