Skip to content

Release/v1.3.0#9

Merged
digitallysavvy merged 2 commits intomainfrom
release/v1.3.0
Apr 2, 2026
Merged

Release/v1.3.0#9
digitallysavvy merged 2 commits intomainfrom
release/v1.3.0

Conversation

@digitallysavvy
Copy link
Copy Markdown
Contributor

This PR improves the agentic developer experience of the Agora skills repo in two areas:

  • tightens repo validation so frontmatter-bearing reference files are checked, not just SKILL.md
  • splits the oversized testing guidance into smaller platform-specific files for better retrieval, maintenance, and context efficiency

What Changed

Validation and Maintainer Docs

  • updated scripts/validate-skills.sh to validate all frontmatter-bearing markdown files under skills/agora/
  • added a description <= 1024 chars validator for frontmatter files
  • improved validator output to report frontmatter-bearing file coverage
  • updated AGENTS.md to reflect the actual repo structure and current MCP guidance

Testing Guidance Refactor

Split skills/agora/references/testing-guidance/SKILL.md into a smaller router plus focused files:

  • testing-guidance/SKILL.md
  • testing-guidance/rtc-web.md
  • testing-guidance/rtc-react.md
  • testing-guidance/rtc-ios.md
  • testing-guidance/rtc-android.md
  • testing-guidance/mobile-rtm-and-renewal.md
  • testing-guidance/convoai-rest.md
  • testing-guidance/completeness-gate.md

This keeps the testing guidance entrypoint small while making platform-specific retrieval more predictable for agents.

Why

The previous validator only applied frontmatter checks to SKILL.md files, which left frontmatter-bearing reference files like server-
sdks.md, auth-flow.md, and quickstarts.md outside that safety net.

The old testing guidance file was also over the intended size limit and mixed multiple stacks into one large document, which made it
harder for agents to load only the relevant testing guidance.

Validation

  • bash scripts/validate-skills.sh

Result:

  • Validation passed: 3 skills, 10 frontmatter files, 45 markdown files checked.

@digitallysavvy digitallysavvy self-assigned this Apr 1, 2026
@digitallysavvy digitallysavvy merged commit 4dd5643 into main Apr 2, 2026
1 check passed
@digitallysavvy digitallysavvy deleted the release/v1.3.0 branch April 2, 2026 03:34
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.

1 participant