makecindy / makecindy/cindy

skill(browser-translate): share the cindy-browser-translate Skill for the in-app page translation button

Open Beginner friendly
#1,061 0 comments 0 reactions 0 assignees View on GitHub
feature
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.