New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Awesome Swift macOS Apps Docs

by jaywcjlove in jaywcjlove/awesome-swift-macos-apps

Maintains app entries in the awesome-swift-macos-apps lists, keeping README.md and README.zh.md in step with one-sentence descriptions and correct category placement.

CC0-1.0Auto-check passedDevelopment

Install Awesome Swift macOS Apps Docs

skills CLI
$ npx skills add jaywcjlove/awesome-swift-macos-apps --skill awesome-swift-macos-apps-docs -a claude-code

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

GitHub CLI
$ gh skill install jaywcjlove/awesome-swift-macos-apps awesome-swift-macos-apps-docs --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/jaywcjlove/awesome-swift-macos-apps.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/awesome-swift-macos-apps-docs .claude/skills/awesome-swift-macos-apps-docs && 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
awesome-swift-macos-apps-docs
GitHub stars
1.7k
Token cost
~1.3k tokens
SKILL.md length
645 words
Files
3 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
CC0-1.0

At a glance

Maintains app entries in the awesome-swift-macos-apps lists, keeping README.md and README.zh.md in step with one-sentence descriptions and correct category placement.

  • Works in 6 steps: Identify the most appropriate category… → Read the local context around the target… → Check whether the app already exists in… → …
  • Adding a new open-source macOS app to the bilingual list
  • SKILL.md covers Use this skill for, Repository Targets, Core workflow and Entry Rules, plus 7 more sections
  • Calls git, ssh and rg

What it does

Both `README.md` and `README.zh.md` are always edited together. The agent first finds the best category by searching existing entries for similar apps or keywords, reads the surrounding section in both languages, checks whether the app is already listed in either file, and then adds or updates the two entries. It finishes by checking placement, wording and formatting with `rg` and `git diff`.

Entry rules ask for one concise sentence per language that states the app's core function rather than a feature list, without stressing that it is a macOS app unless that matters. The English and Chinese lines should match in meaning without being translated word for word. Existing markdown, badges and ordering, usually alphabetical or grouped with similar tools, stay as they are, neighboring entries are left alone, and the display name follows what you asked for. Two reference files cover supported files and category notes.

When your agent uses it

  • Adding a new open-source macOS app to the bilingual list
  • Fixing a wrong link, duplicate or mismatched description in both README files
  • Moving an existing entry into a better category

Example prompts

  • “Add the Swift app Maccy, a clipboard manager, to both READMEs in the right category.”
  • “Fix the duplicate entry for the screenshot tool and make the descriptions match in both languages.”
  • “Move the menu bar timer app to a more fitting section in README.md and README.zh.md.”

Requirements

  • The awesome-swift-macos-apps repository
  • ripgrep (`rg`) and Git for the final checks

Workflow steps

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

  1. Identify the most appropriate category by searching existing README files for similar apps or keywords.
  2. Read the local context around the target section in both languages before editing.
  3. Check whether the app already exists in either file.
  4. Add or update both entries together.
  5. Keep the description to one sentence in each language.
  6. Verify placement, wording, and formatting with rg and git diff.

What it can do on your machine

Read from SKILL.md and the folder at commit 83ea341. 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:

    • git
    • ssh
    • rg

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

  • Network

    No URLs in SKILL.md. Its commands use git and ssh, 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

Awesome Swift macOS Apps Docs loads about 1.3k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 645 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

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 jaywcjlove/awesome-swift-macos-apps at commit 83ea341, republished under its CC0-1.0 licence (© jaywcjlove). 645 words, ~1,258 tokens.

Download SKILL.mdSave it as .claude/skills/awesome-swift-macos-apps-docs/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
awesome-swift-macos-apps-docs
description
Use when adding, updating, or validating app entries in the awesome-swift-macos-apps repository, especially when maintaining both README.md and README.zh.md with concise one-sentence descriptions, correct category placement, and consistent bilingual formatting.

Awesome Swift macOS Apps Docs

Use this skill when the task is to maintain app entries in this repository's bilingual docs.

Use this skill for

  • Adding a new app entry to README.md and README.zh.md
  • Updating an existing app entry in both files
  • Fixing wrong links, duplicate entries, inconsistent descriptions, or mismatched category placement
  • Moving an existing app entry to a better category while preserving local document structure
  • Keeping reply format consistent for this repository

Do not use this skill for code changes in other projects.

For supported files and default scope boundaries, see references/supported-files.md. For category-specific notes and placement heuristics, see references/category-notes.md.

Repository Targets

Always update both files together:

  • README.md
  • README.zh.md

Core workflow

  1. Identify the most appropriate category by searching existing README files for similar apps or keywords.
  2. Read the local context around the target section in both languages before editing.
  3. Check whether the app already exists in either file.
  4. Add or update both entries together.
  5. Keep the description to one sentence in each language.
  6. Verify placement, wording, and formatting with rg and git diff.

Entry Rules

For each new app entry:

  • Use a single concise sentence to describe what the app is
  • Prefer describing the core function, not a feature list
  • Do not emphasize that it is a macOS app unless that is essential to understanding the app
  • Keep English and Chinese descriptions aligned in meaning, but do not translate mechanically
  • Preserve existing markdown format, badges, and ordering style used in the target section
  • Keep naming consistent with the user's request; if the repo name differs from the display name, follow the user's requested display name unless there is a strong reason not to

Curation Rules

  • Match the local section used by each document instead of assuming both files are structured identically.
  • Preserve existing ordering within a section. In practice this is usually alphabetical by app name or grouped with similar nearby tools.
  • Do not rewrite neighboring entries unless needed for the requested task.
  • Keep edits narrowly scoped to the requested listing work.

Category Placement

Choose the closest existing category based on the app's main purpose.

Heuristics:

  • AI clients, coding-agent dashboards, AI utilities: AI
  • Local model runtimes and model-serving tools: Local LLM
  • Terminal environments, multiplexers, SSH/native shell workspaces: Terminal
  • Docker-based local web/dev stack tools: Web Development
  • Git identity/config/dev helper tools: Other Development
  • Window tiling, snapping, positioning: Window Management
  • Clipboard tools: Clipboard
  • Audio/video players: Player
  • Keyboard layout/input overlays: Keyboard
  • Screenshot/OCR/capture tools: screenshot-related section already present in main list; place near similar entries
  • If no category is clearly better, use Other

When unsure, inspect nearby entries before editing.

Show full SKILL.md (212 more words)Show less

Description Style

English:

  • Short and direct
  • Prefer noun-phrase or simple functional sentence fragments
  • Avoid marketing words like "powerful", "beautiful", "premium", "ultimate" unless needed for meaning
  • Avoid long feature enumerations

Chinese:

  • Keep it natural and concise
  • Prefer patterns like 用于…的工具 / …管理工具 / …客户端 / …工作台
  • Do not force exact word order from English

Preferred patterns:

  • Git identity manager for switching profiles, emails, and SSH keys.
  • SSH workspace for Hermes with sessions, files, usage, skills, and a real terminal.
  • 集截图、录屏、标注、OCR 和贴屏展示于一体的工具。

Validation

  • Search for the app name in README.md and README.zh.md
  • Review git diff for only the intended changes
  • Confirm the entry appears once per intended file
  • Confirm the wording remains one sentence in each language
  • Confirm final line numbers with rg -n

Reply Format

After finishing, reply briefly with:

  • whether it was added or updated
  • English file location
  • Chinese file location
  • final English description
  • final Chinese description
  • whether tests were run; for doc-only changes, say tests were not run

Notes

Common user preference for this repository:

  • "描述简明扼要"
  • "一句话说明是个什么应用"
  • "不要强调 macOS 应用" unless the user explicitly asks otherwise

Scope Boundary

  • This skill is for repository curation, not for rewriting repository structure or reformatting unrelated content.
  • If the user asks for a broader taxonomy change, inspect the surrounding sections first and then make the smallest consistent change.

© jaywcjlove, CC0-1.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .codex/skills/awesome-swift-macos-apps-docs of jaywcjlove/awesome-swift-macos-apps.

  • SKILL.md
  • references/category-notes.md
  • references/supported-files.md

Open the folder on GitHubat commit 83ea341

Compare with similar skills

Awesome Swift macOS Apps Docs 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.

Awesome Swift macOS Apps Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Awesome Swift macOS Apps Docs this skilljaywcjlove/awesome-swift-macos-apps1.7k—~1.3kAutomated safety check: PassCC0-1.0
Moonbit Docs Maintainermoonbitlang/moonbit-docs2.5k—~1.1kAutomated safety check: PassCustom licence
Translate It Doc En Zhmxsm/rocketmq-rust1.5k—~1.2kAutomated safety check: PassApache-2.0
Bilingual JsdocMichealWayne/fe-tools207—~299Automated safety check: PassNone
Create Module FileMichealWayne/fe-tools207—~381Automated safety check: PassNone
Technical Analystjeremylongshore/tons-of-skills-marketplace2.8k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Moonbit Docs Maintainer

    moonbitlang/moonbit-docs

    A skill your agent uses when maintaining the moonbitlang/moonbit-docs repository, including Sphinx docs under next/, MoonBit examples under next/sources/, error-code documentation, gettext…

    2.5k GitHub stars~1.1k tokensUpdated 20 days ago
    DevelopmentAuto-check passed

  • Translate It Doc En Zh

    mxsm/rocketmq-rust

    Translate English IT and software engineering documents into professional, accurate Chinese.

    1.5k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed

  • Bilingual Jsdoc

    MichealWayne/fe-tools

    Write or update bilingual (Chinese + English) JSDoc for exported functions in fe-tools.

    207 GitHub stars~299 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

  • Create Module File

    MichealWayne/fe-tools

    Create a new module file for fe-tools utilities. An agent skill from MichealWayne/fe-tools.

    207 GitHub stars~381 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

  • Technical Analyst

    jeremylongshore/tons-of-skills-marketplace

    Technical analysis translator for Product Managers. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Dsh Web Documentation

    zhu1090093659/dsh-web

    A skill your agent uses when adding or editing dsh-web README files, docs, AGENTS.md instructions, user-facing configuration text, or bilingual documentation pairs.

    8.6k GitHub stars~479 tokensUpdated today
    Agent WorkflowsAuto-check passed

Works with

Categories

Questions about Awesome Swift macOS Apps Docs

What does Awesome Swift macOS Apps Docs do?

Maintains app entries in the awesome-swift-macos-apps lists, keeping README.md and README.zh.md in step with one-sentence descriptions and correct category placement. md` are always edited together. The agent first finds the best category by searching existing entries for similar apps or keywords, reads the surrounding section in both languages, checks whether the app is already listed in either file, and then adds or updates the two entries.

When should I use Awesome Swift macOS Apps Docs?

Awesome Swift macOS Apps Docs fits situations like: adding a new open-source macOS app to the bilingual list; fixing a wrong link, duplicate or mismatched description in both README files; moving an existing entry into a better category.

How do I install Awesome Swift macOS Apps Docs in Claude Code?

Run `npx skills add jaywcjlove/awesome-swift-macos-apps --skill awesome-swift-macos-apps-docs -a claude-code`. Or copy the skill folder (.codex/skills/awesome-swift-macos-apps-docs in jaywcjlove/awesome-swift-macos-apps) into .claude/skills/awesome-swift-macos-apps-docs in your project. Claude Code loads it when a task matches its description.

How do I install Awesome Swift macOS Apps Docs in Codex?

Run `npx skills add jaywcjlove/awesome-swift-macos-apps --skill awesome-swift-macos-apps-docs -a codex`. Or copy the skill folder (.codex/skills/awesome-swift-macos-apps-docs in jaywcjlove/awesome-swift-macos-apps) into .agents/skills/awesome-swift-macos-apps-docs in your project. Codex loads it when a task matches its description.

Can I use Awesome Swift macOS Apps Docs 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 jaywcjlove/awesome-swift-macos-apps --skill awesome-swift-macos-apps-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/awesome-swift-macos-apps-docs, .gemini/skills/awesome-swift-macos-apps-docs, .github/skills/awesome-swift-macos-apps-docs and .opencode/skills/awesome-swift-macos-apps-docs in your project.

What does Awesome Swift macOS Apps Docs need to run?

Going by SKILL.md and its folder, Awesome Swift macOS Apps Docs needs the command-line tools its instructions call (git, ssh and rg). Our summary lists: The awesome-swift-macos-apps repository; ripgrep (`rg`) and Git for the final checks.

Does Awesome Swift macOS Apps Docs access the network?

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

Is Awesome Swift macOS Apps Docs 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 Awesome Swift macOS Apps Docs use?

Awesome Swift macOS Apps Docs is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Awesome Swift macOS Apps Docs use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 850 tokens, read only when the agent opens those files.

What are the alternatives to Awesome Swift macOS Apps Docs?

Skills that share tags, products or a category with Awesome Swift macOS Apps Docs: Moonbit Docs Maintainer (moonbitlang/moonbit-docs, 2.5k stars), Translate It Doc En Zh (mxsm/rocketmq-rust, 1.5k stars), Bilingual Jsdoc (MichealWayne/fe-tools, 207 stars) and Create Module File (MichealWayne/fe-tools, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Awesome Swift macOS Apps Docs?

jaywcjlove (a GitHub user) maintains it in jaywcjlove/awesome-swift-macos-apps, which has 1,731 GitHub stars. The repository was last updated on October 11, 2026.

Source: jaywcjlove/awesome-swift-macos-apps on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.