← Back to Skills Marketplace
66
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install miaoda-app-chat-sync
Description
Convert Git repository code to structured JSON instructions for AI agents. Fetches code from Git repositories (GitHub, GitLab, etc.), generates structured JS...
Usage Guidance
What to consider before installing:
- The tool does what it claims (clones repos and outputs JSON), but there are mismatches between docs and metadata (mentions GITLAB_TOKEN and Miaoda IDs that aren't declared).
- The implementation embeds GITHUB_TOKEN into HTTPS remote URLs before running git. That can cause tokens to appear in .git/config, command arguments, process listings, or logs if cleanup fails. Use a short-lived, minimal-scope token (read-only repo scope) when testing.
- Test first with a public repository and a throwaway token in an isolated/sandboxed environment to confirm cleanup behavior. Inspect that temporary directories are removed and that no token strings are printed to stdout/stderr or left in config files.
- If you need GitLab or other providers, note the code primarily handles github.com and may not support other providers' authentication safely.
- If you plan to use this in automation, consider modifying the code to avoid embedding tokens in URLs (use credential helpers or git credential environment patterns) and to explicitly zero out or redact sensitive values before any logging.
If you are not comfortable auditing code yourself, do not provide real production credentials to this skill and consider running it locally with an isolated test token first.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's name/description (convert Git repos to JSON) aligns with the included script and required binaries (python3, git). However README/SKILL.md mention additional prerequisites (GITLAB_TOKEN, Miaoda App ID/Context ID) that are not declared in the registry metadata; the code's authentication logic only actively handles GITHUB_TOKEN and only special-cases github.com. This is an inconsistency but not proof of malicious intent.
Instruction Scope
Runtime instructions and the script perform broad repo operations: initialize a git repo, add a remote with an authenticated URL, fetch history, read all text files, and output JSON. These actions are expected for the stated purpose, but the implementation embeds tokens into remote URLs (auth_url) which can end up in repository config or process arguments and could be exposed in logs or process listings. README asserts 'token never stored' and 'temp files cleaned' but those guarantees rely on proper cleanup; any failure could leave tokens or repo contents on disk.
Install Mechanism
Instruction-only skill with no install spec and only standard binaries required; included Python script uses standard library and git CLI. No external downloads, package registry installs, or archive extraction were found.
Credentials
The skill declares a single primary credential (GITHUB_TOKEN), which is proportionate for private GitHub repo access. However documentation suggests other tokens (GITLAB_TOKEN) and Miaoda IDs not declared in metadata. More importantly, the code inserts tokens into remote URLs (e.g., https://<token>@github.com/...), which can expose credentials via .git/config, command arguments, or logs — this increases the risk of credential leakage even though only one credential is requested.
Persistence & Privilege
always:false and disable-model-invocation:false (normal). The skill does not request persistent system-wide privileges or modify other skills' configs in the provided files. Temporary directories are used; README claims automatic cleanup.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install miaoda-app-chat-sync - After installation, invoke the skill by name or use
/miaoda-app-chat-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
No file changes detected for version 2.0.0.
- No modifications were made in this release.
- Skill content and functionality remain unchanged from previous version.
v1.0.1
- Renamed skill from "miaoda-app-chat-sync" to "repo-json-generator" for platform-agnostic usage.
- Added scripts/repo_json_generator.py to generate structured JSON instructions from any Git repository, not just GitHub.
- Removed the old scripts/github_sync.py file specific to GitHub syncing.
- Updated documentation to reflect broader Git platform support (GitHub, GitLab, Bitbucket, etc.).
- JSON output format and collaboration flow remain consistent, now usable with any AI agent, not limited to Miaoda platform.
v1.0.0
miaoda-app-chat-sync v1.0.0
- Initial release providing GitHub-to-Miaoda code sync via structured JSON instructions.
- Supports full project sync, batch processing for large codebases, and incremental updates of changed files.
- Collaborates with miaoda-app-builder for accurate and verifiable file updates through Miaoda chat API.
- Includes detailed trigger phrases (Chinese and English) and workflow documentation.
- Requires Python 3, Git, and GITHUB_TOKEN environment variable for operation.
Metadata
Frequently Asked Questions
What is miaoda-app-chat-sync?
Convert Git repository code to structured JSON instructions for AI agents. Fetches code from Git repositories (GitHub, GitLab, etc.), generates structured JS... It is an AI Agent Skill for Claude Code / OpenClaw, with 66 downloads so far.
How do I install miaoda-app-chat-sync?
Run "/install miaoda-app-chat-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is miaoda-app-chat-sync free?
Yes, miaoda-app-chat-sync is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does miaoda-app-chat-sync support?
miaoda-app-chat-sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created miaoda-app-chat-sync?
It is built and maintained by xiaoanso (@xiaoanso); the current version is v2.0.0.
More Skills