Agent skill

Sync Miniapp

by Mentra-Community in Mentra-Community/MentraOS

Prepare an external Mentra miniapp for bundling into mobile/assets/miniapps (version bump, pack, zip install, regenerate bundledMiniapps).

Apache-2.0Auto-check passed

Install Sync Miniapp

skills CLI
$ npx skills add Mentra-Community/MentraOS --skill sync-miniapp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Mentra-Community/MentraOS sync-miniapp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Mentra-Community/MentraOS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/sync-miniapp .claude/skills/sync-miniapp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sync-miniapp
GitHub stars
2.4k
Token cost
~430 tokens
SKILL.md length
152 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Prepare an external Mentra miniapp for bundling into mobile/assets/miniapps (version bump, pack, zip install, regenerate bundledMiniapps).

  • Works in 6 steps: Reads miniapp.json (packageName +… → Bumps strict MAJOR.MINOR.PATCH (rejects… → Runs the external repo's bun run pack… → …
  • The user asks to sync a miniapp
  • SKILL.md covers Command, What it does, Critical: no commits and Agent workflow
  • Calls bun and git

What it does

Sync Miniapp is an agent skill from Mentra-Community/MentraOS. Prepare an external Mentra miniapp for bundling into mobile/assets/miniapps (version bump, pack, zip install, regenerate bundledMiniapps). Use when the user asks to sync a miniapp, bundle livestreamer/notes/etc into the Mentra App, or update mobile/assets/miniapps from an external miniapp repo. Never commits or pushes.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: MentraOS is the leading smart glasses OS. See live captions, stream your view, talk to AI, and capture photos hands-free on compatible glasses. The licence is Apache-2.0.

When your agent uses it

  • The user asks to sync a miniapp
  • Bundle livestreamer/notes/etc into the Mentra App
  • Update mobile/assets/miniapps from an external miniapp repo

Example prompts

  • “/sync-miniapp”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Reads miniapp.json (packageName + version are canonical).
  2. Bumps strict MAJOR.MINOR.PATCH (rejects prerelease/build unless --no-bump).
  3. Runs the external repo's bun run pack (or vendored mentra-miniapp pack).
  4. Verifies the zip's embedded miniapp.json.
  5. Copies into mobile/assets/miniapps/, prunes older same-package zips.
  6. Regenerates mobile/src/generated/bundledMiniapps.ts.

What it can do on your machine

Read from SKILL.md and the folder at commit ef49574. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bun
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sync Miniapp loads about 430 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 152 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~430

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Mentra-Community/MentraOS at commit ef49574, republished under its Apache-2.0 licence (© Mentra-Community). 152 words, ~430 tokens.

Download SKILL.mdSave it as .claude/skills/sync-miniapp/SKILL.md (or your agent's skills folder).
name
sync-miniapp
description
Prepare an external Mentra miniapp for bundling into mobile/assets/miniapps (version bump, pack, zip install, regenerate bundledMiniapps). Use when the user asks to sync a miniapp, bundle livestreamer/notes/etc into the Mentra App, or update mobile/assets/miniapps from an external miniapp repo. Never commits or pushes.

Sync miniapp (prepare only — no git commits)

Command

From the MentraOS repo root:

bash
bun scripts/sync-miniapp.mjs <name> [--bump patch|minor|major] [--no-bump] [--dry-run]
# or
bun scripts/sync-miniapp.mjs --repo /path/to/external-miniapp [--bump patch] [--dry-run]

Named repos live in scripts/miniapp-repos.json.

What it does

  1. Reads miniapp.json (packageName + version are canonical).
  2. Bumps strict MAJOR.MINOR.PATCH (rejects prerelease/build unless --no-bump).
  3. Runs the external repo's bun run pack (or vendored mentra-miniapp pack).
  4. Verifies the zip's embedded miniapp.json.
  5. Copies into mobile/assets/miniapps/, prunes older same-package zips.
  6. Regenerates mobile/src/generated/bundledMiniapps.ts.

Critical: no commits

This skill must not run git add, git commit, or git push in either the external miniapp repo or MentraOS.

After a successful run, tell the user:

No commits made. Remaining manual steps: commit+push in <repoPath>, then commit the MentraOS changes.

Agent workflow

  1. Prefer --dry-run first if the user wants a preview.
  2. Run the script; do not reimplement pack/copy by hand.
  3. Report old → new version and destination zip path.
  4. Never commit unless the user explicitly asks in a separate request.

© Mentra-Community, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/sync-miniapp of Mentra-Community/MentraOS.

Open the folder on GitHubat commit ef49574

Compare with similar skills

Sync Miniapp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sync Miniapp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sync Miniapp this skillMentra-Community/MentraOS2.4k—~430Automated safety check: PassApache-2.0
React Syncvercel/next.js143k—~486Automated safety check: PassMIT
Miniappyc-software/qm15k—~212Automated safety check: PassMIT
Audit Preparationsickn33/agentic-awesome-skills47k1 repos~5.3kAutomated safety check: PassMIT
Claude-Mem Cloud Syncthedotmack/claude-mem99k—~1kAutomated safety check: NotesApache-2.0
Agent Sync Coordinatorruvnet/ruflo74k2 repos~4kAutomated safety check: PassMIT

Similar skills

  • React Sync

    vercel/next.js

    Official

    Build local React changes in the bundle variants consumed by Next.js, sync them into a local Next.js checkout, and test the resulting integration.

    143k GitHub stars~486 tokensUpdated today
    Auto-check passed
  • Miniapp

    yc-software/qm

    Build a tiny interactive HTML playground only when someone asks to see, play with, or step through a mechanism.

    15k GitHub stars~212 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Audit Preparation

    sickn33/agentic-awesome-skills

    Audit preparation register: required document, period covered, request and receipt dates, preparer and reviewer, auditor queries and adjustments.

    47k GitHub starsUsed in 1 repo~5.3k tokens
    Legal & ComplianceAuto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    99k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Agent skill for sync-coordinator - invoke with $agent-sync-coordinator

    74k GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • External Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing content pages for citation quality, suggesting authoritative sources to link for factual claims, or reviewing whether a page's external link attributes…

    74k GitHub stars~773 tokensUpdated 3 days ago
    Research & ScienceAuto-check passed

More from Mentra-Community/MentraOS

All 11 skills in this repo
  • Investigate Routine Failure

    Mentra-Community/MentraOS

    Investigate a Mentra routine failure from an Admin testRun URL or run/request ID, fetch authenticated results and verified artifacts with the existing incident-report token, trace the exact routine…

    2.4k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Mentra Update Live Firmware

    Mentra-Community/MentraOS

    Update MentraOS firmwarelive.json from the published BES and MTK feeds and prepare a PR, preserving production MTK upgrade paths.

    2.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • CI Triage

    Mentra-Community/MentraOS

    Triage failing GitHub PR checks: list failures with gh, fetch capped Actions logs, skip non-Actions checks, and summarize root cause.

    2.4k GitHub stars~582 tokensUpdated today
    Auto-check passed
  • Codex PR Review

    Mentra-Community/MentraOS

    Run an independent local Codex (gpt-6.1-sol, medium) review of a GitHub pull request and relay its verdict.

    2.4k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Manage Cloud Env

    Mentra-Community/MentraOS

    Add or change backend deployment environment variables through Doppler shared configs and native Porter syncs.

    2.4k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Fix Nightly Failures

    Mentra-Community/MentraOS

    Diagnose an ongoing or finished Mentra nightly suite, group demonstrated shared failures, implement fixes, and carry PRs through independent Codex review and merge.

    2.4k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Sync Miniapp

What does Sync Miniapp do?

Prepare an external Mentra miniapp for bundling into mobile/assets/miniapps (version bump, pack, zip install, regenerate bundledMiniapps). Sync Miniapp is an agent skill from Mentra-Community/MentraOS. Prepare an external Mentra miniapp for bundling into mobile/assets/miniapps (version bump, pack, zip install, regenerate bundledMiniapps).

When should I use Sync Miniapp?

Sync Miniapp fits situations like: the user asks to sync a miniapp; bundle livestreamer/notes/etc into the Mentra App; update mobile/assets/miniapps from an external miniapp repo.

How do I install Sync Miniapp in Claude Code?

Run `npx skills add Mentra-Community/MentraOS --skill sync-miniapp -a claude-code`. Or copy the skill folder (.agents/skills/sync-miniapp in Mentra-Community/MentraOS) into .claude/skills/sync-miniapp in your project. Claude Code loads it when a task matches its description.

How do I install Sync Miniapp in Codex?

Run `npx skills add Mentra-Community/MentraOS --skill sync-miniapp -a codex`. Or copy the skill folder (.agents/skills/sync-miniapp in Mentra-Community/MentraOS) into .agents/skills/sync-miniapp in your project. Codex loads it when a task matches its description.

Can I use Sync Miniapp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Mentra-Community/MentraOS --skill sync-miniapp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sync-miniapp, .gemini/skills/sync-miniapp, .github/skills/sync-miniapp and .opencode/skills/sync-miniapp in your project.

What does Sync Miniapp need to run?

Going by SKILL.md and its folder, Sync Miniapp needs the command-line tools its instructions call (bun and git).

Does Sync Miniapp access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Sync Miniapp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sync Miniapp use?

Sync Miniapp is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sync Miniapp use?

About 430 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sync Miniapp?

Skills that share tags, products or a category with Sync Miniapp: React Sync (vercel/next.js, 143k stars), Miniapp (yc-software/qm, 15k stars), Audit Preparation (sickn33/agentic-awesome-skills, 47k stars) and Claude-Mem Cloud Sync (thedotmack/claude-mem, 99k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sync Miniapp?

Mentra-Community (a GitHub organization) maintains it in Mentra-Community/MentraOS, which has 2,380 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 9, 2026.

Source: Mentra-Community/MentraOS on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.