skill(browser-translate): share the cindy-browser-translate Skill for the in-app page translation button
- Dominant language
- TypeScript
- Stars
- 2.7k
- Forks
- 395
- Avg merge
- 21h 48m
- Merged PRs (30d)
- 776
Description
**提交人**: shuji
**客户端版本**: 0.0.0
---
## Summary
Companion deliverable for #1058 (feat(browser): add an in-app page translation button).
This issue shares the **`cindy-browser-translate` Skill** so other developers and users can drive the in-app browser translation button through the agent. The Skill has been validated locally and is packaged as `cindy-browser-translate.skill.zip`.
## Skill definition (SKILL.md)
```markdown
---
name: cindy-browser-translate
description: Open a web page in Cindy's built-in browser and translate the current page using Cindy's visible browser translation button. Use when the user asks to translate a URL, translate the current browser page, or says 翻译此页、翻译这个网页、translate this page, especially when they want the action performed inside Cindy rather than in a system browser.
---
# Cindy Browser Translate
Use Cindy's in-app Browser to open an HTTP(S) page and translate it through the browser toolbar. This skill performs the browser action; it does not translate pasted text or create a standalone translation.
## Workflow
1. Resolve the target page.
- Use the URL in the user's request.
- If the user refers to the current page, inspect the active Cindy Browser tab.
- If there is no URL and no active page, ask the user for a web address.
- Accept only `http://` and `https://` URLs. Do not translate `file:`, `javascript:`, `about:`, or custom-protocol pages.
2. Use Cindy's built-in Browser controls to open or focus the page. Do not open a separate system browser unless the user explicitly asks for one.
3. Wait for the page to load, then inspect the browser toolbar for the visible `Translate`/`翻译`/`翻訳`/`번역` button.
4. Click the translation button. Cindy creates a Google hosted translation view for the current page and chooses the target language from Cindy's current interface locale. If the user specifies a target language, use that language when the Browser supports it; otherwise use Cindy's current locale.
5. Verify that navigation completed to a translation view and that the original page remains the translation source. Report the result briefly, including the target language when known.
## Failure Handling
- If the in-app Browser runtime is unavailable, say that Cindy's Browser is not running or not available. Do not claim that translation succeeded.
- If the translation button is missing, tell the user to update/rebuild and restart Cindy, then retry. Do not simulate a click.
- If the page blocks the translation service, report that the page could not be translated and leave the original page available.
- If the URL is not HTTP(S), explain that only normal web pages can be translated.
## Privacy and Safety
- Keep the operation scoped to the URL and active tab provided by the user.
- Do not copy, expose, or transmit cookies, credentials, local storage, or page secrets.
- Do not translate private content or submit forms unless the user explicitly requests that separate action.
- Before navigating away from a page with unsaved form data, warn the user and ask for confirmation.
## Examples
- `翻译这个网页:https://services.digital.go.jp/visit-japan-web/`
- `Translate the current page to Chinese.`
- `Open https://example.com in Cindy and translate it.`
```
## Package layout
```
skills/cindy-browser-translate/
├── SKILL.md
└── agents/openai.yaml
```
## How to use
1. Install the Skill into your Cindy skills directory (or unpack `cindy-browser-translate.skill.zip`).
2. Requires a Cindy build that includes the browser translation button from #1058.
3. Ask Cindy e.g. “翻译这个网页:https://services.digital.go.jp/visit-japan-web/”.
## Relationship to #1058
- #1058 tracks the product feature (toolbar translate button in the built-in browser).
- This issue shares the agent-side Skill that operates that button, so the two can be reviewed/adopted together.
---
**OS**: darwin arm64 (25.5.0)
**界面语言**: zh-CN
Contributor guide
Research direction
Start with the documented layout under skills/cindy-browser-translate/, reading SKILL.md and checking the referenced agents/openai.yaml. Verify that the Skill package includes both files, can be installed or unpacked as described, and supports the translation workflow and example request using a build with the browser translation button.
Written by the indexing model from the issue text.
Assessment
- Domain
- ai, tooling
- Issue type
- Feature
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 78/100