Repository navigation
Release Process
Mobile AI Agents npm releases are published by GitHub Actions from git tags.
Do not run npm publish manually. Manual publishing can race with the tag workflow and cause npm to reject the workflow with:
403 Forbidden - You cannot publish over the previously published versions
- If the release adds or renames an agent, skill, or workflow, update every install surface before changing the version:
# Required source file
agents/<platform>/<name>/agent.md
skills/<platform>/<name>.md
workflows/<name>.md
# Required CLI registry entries
cli/index.jsChecklist:
- Add the item to the matching
AGENTS,SKILLS, orWORKFLOWSobject incli/index.js. - Add cross-platform skills to every relevant
PLATFORM_SKILLSbundle soinstall --platform all, Android, iOS, Flutter, React Native, and other platform installs include them. - Add cross-platform agents to every relevant
PLATFORM_AGENTSbundle when they should install with platform-specific setups. - Update README/docs counts, command lists, wiki content, and install examples when totals or names change.
- Run
node cli/index.js listand confirm the item appears under the expected section. - Run an isolated install test and confirm the slash command file is created:
tmp_home="$(mktemp -d)"
HOME="$tmp_home" node cli/index.js install --platform all --tool claude
test -f "$tmp_home/.claude/commands/<name>.md"- Update
package.json:
{
"version": "1.0.19"
}- Run local checks:
git diff --check
npm test
node --check cli/index.js
bash -n install.sh
node cli/index.js list
npm pack --dry-run- Commit the version bump:
git add package.json
git commit -m "Release v1.0.19"If the release also changes docs, CLI, agents, skills, or workflows, include those files in the same release commit.
- Create the tag locally:
git tag v1.0.19- Push the branch and tag:
git push origin main
git push origin v1.0.19- Let GitHub Actions publish npm and create the GitHub Release.
The workflow is .github/workflows/publish.yml. It runs on tags matching v*, verifies the tag version matches package.json, checks whether the version already exists on npm, and publishes only when the version is new. It also creates or updates the GitHub Release with generated notes.
Release notes must compare against the latest existing GitHub Release tag. The workflow passes that tag explicitly to GitHub's release-notes API so the Full Changelog range does not fall back to an older tag.
After the workflow finishes:
npm view mobile-ai-agents version dist-tags.latest
npm view mobile-ai-agents@1.0.19 version dist.tarball dist.shasum
git ls-remote origin refs/heads/main refs/tags/v1.0.19
gh release view v1.0.19 --json body,urlExpected:
- npm latest equals the released version.
- GitHub
mainpoints to the release commit. - GitHub tag
v1.0.19points to the same release commit. - GitHub Actions publish workflow is green.
- GitHub Release notes compare from the previous release tag to the new tag.
- New agents, skills, or workflows appear in
node cli/index.js listand are installed by the matchinginstallcommand.
- Never run
npm publishmanually for normal releases. - Never push a tag before
package.jsonis updated and committed. - The tag must match the package version exactly:
package.json1.0.19uses tagv1.0.19. - If a workflow is rerun for an already-published version, it should skip publishing instead of failing.
- Do not rely on GitHub's web UI default "Generate release notes" range. Use the workflow or pass the previous tag explicitly.
- Do not release a new agent, skill, or workflow until the CLI manifest and platform install bundles include it.
Getting Started
Documentation
- All Documentation
- Installation
- Figma MCP and Design Handoff
- Figma Spec Tools
- Core Loops
- Mobile Engineering Loop
- Mobile Memory
- Performance Loop
Reference
- Agents
- Platform Guide
- Skills and Prompts
- Android Device QA Setup
- Mobile App Design Skill
- Mobile Harness
- Enterprise Mobile Harness
- Workflows
- Reference
Community
Repository github.com/salmanashraf/mobile-ai-agents
Version: v1.0.38 · MIT License