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

/skill-maintenance

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

Create, update, validate, or reorganize repo-local Agent Skills under .agents/skills, including SKILL.md frontmatter, first-level references, compatibility symlinks, and validation scripts. Use only for skill-tree maintenance, skill taxonomy changes, or agent-guidance validation work.

Use this Skill: https://skilld.dev/gh/composiohq/composio/skill-maintenance

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

referencesskill-format.md

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

Skill Format

Canonical Tree

  • .agents/skills is canonical.
  • .claude/skills is a compatibility symlink to .agents/skills.
  • Do not maintain parallel hand-edited skill copies.

Required Structure

Each skill directory must contain SKILL.md with YAML frontmatter:

---
name: skill-name
description: What the skill does and when to use it.
---

Rules:

  • name must match the directory name.
  • Use lowercase letters, digits, and hyphens only.
  • Include trigger boundaries in description; it is the routing surface agents see before loading the body.
  • Keep SKILL.md short. Put detailed examples, command recipes, and package-specific notes in first-level references/*.md.
  • Link every reference directly from SKILL.md; avoid nested reference-chasing.
  • Do not add agents/openai.yaml unless repo tooling explicitly needs UI metadata.

Primary Sources Checked

  • OpenAI Codex Agent Skills docs: skills are directories with SKILL.md, optional scripts/, references/, assets/, and optional agents/.
  • Claude Agent Skills docs: every skill requires SKILL.md frontmatter with name and description.
  • VS Code Agent Skills docs: name should match the parent directory and use lowercase hyphenated identifiers.

Validation

Run:

bun run validate:agent-skills
bun run validate:skill-routing

Both validators are deterministic, and .github/workflows/agent-substrate.yml runs them in CI on every push and pull request — the stale-guidance scan covers the whole repo, so any change can affect the result.

validate:agent-skills checks frontmatter, names, reference links, compatibility symlink state, stale guidance references, and known command names.

validate:skill-routing is a deterministic routing smoke test (ts/scripts/test-skill-routing.ts): for representative tasks it asserts the expected skill is the unique top match by distinctive trigger phrases, and fails if any skill has no probe. When you add or rename a skill, or rewrite a description, add or update its probe so routing stays covered.

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.

No alerts2d3 checks · Risk SAFE
  • Gen Agent Trust Hub2d

    This skill provides a framework and guidelines for maintaining other agent skills within a repository. It defines structural requirements, naming conventions, and validation procedures using local development tools. No malicious patterns or security vulnerabilities were detected.

  • Socket21d

    No alerts

  • Snyk2d

    Risk: LOW · No issues

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/skill-maintenance