Skip to content

 This project is dedicated to collecting high-quality macOS software and organizing them systematically by different categories for easy search and use.

Add awesome-mac maintainer skill

小弟调调8b8f3c7b9772
diff --git a/.codex/skills/awesome-mac-maintainer/SKILL.md b/.codex/skills/awesome-mac-maintainer/SKILL.md
new file mode 100644
index 00000000..21eb4313
--- /dev/null
+++ b/.codex/skills/awesome-mac-maintainer/SKILL.md
@@ -0,0 +1,75 @@
+---
+name: awesome-mac-maintainer
+description: Maintain the Awesome Mac repository when adding, updating, or relocating app entries across README.md, README-zh.md, README-ja.md, and README-ko.md. Use this when the task requires category selection, multilingual sync, concise listing copy, ordering consistency, or repository-specific curation rules.
+---
+
+# Awesome Mac Maintainer
+
+Use this skill for repository curation tasks that touch app listings, especially when the user wants to add, update, or reclassify an app across the English, Chinese, Japanese, and Korean READMEs.
+
+## Use this skill for
+
+- Add a new app entry to the right category in `README.md`.
+- Sync the same app into `README-zh.md`, `README-ja.md`, and `README-ko.md`.
+- Update or shorten an existing listing without drifting from repository style.
+- Move an entry to a better category while preserving local document structure.
+
+For supported repository files and scope boundaries, see [references/supported-files.md](references/supported-files.md).
+
+## Core workflow
+
+1. Identify the most appropriate category by searching the existing README files for similar apps or keywords.
+2. Read the local context around the target section in each language before editing.
+3. Add or update the entry in all required language files.
+4. Keep the description to one sentence.
+5. Verify placement, wording, and formatting with `rg` and `git diff`.
+
+## Curation rules
+
+- Match the local section used by each document instead of assuming all four files have identical structure.
+- Preserve existing ordering within a section. In practice this is usually alphabetical by app name.
+- Do not rewrite neighboring entries unless needed for the requested task.
+- Keep edits narrowly scoped to the requested listing work.
+
+## Description style
+
+- Explain what the app is in one sentence.
+- Keep it brief and concrete.
+- Prefer product identity over feature lists.
+- Do not emphasize that the app is a macOS app unless that detail is necessary.
+- Avoid marketing phrasing unless the repository already uses it for that exact product.
+
+Preferred patterns:
+
+- "Open-source HTTP(S) debugging proxy for intercepting, inspecting, modifying, and replaying requests."
+- "Open-source screen recorder and editor for polished demos, tutorials, and product videos."
+- "Open-source tool for switching Git identities and managing SSH keys."
+
+## Icons and links
+
+- Use the product site or primary project URL for the main link when that matches surrounding entries.
+- If the project is open source and the repository URL is known, add the OSS icon linking to the repository.
+- If the project is presented as free/open source and nearby entries use the freeware marker, add `![Freeware][Freeware Icon]`.
+- Follow the exact icon formatting already used in the target section.
+
+## Category selection guidance
+
+- Prefer the category that contains the closest comparable apps already in the repo.
+- For developer tools, distinguish between:
+ - API clients / API development
+ - Network analysis / debugging proxies
+ - Version control
+- For media apps, check whether the document uses a broad audio/video section or a dedicated streaming music subsection.
+- If Chinese uses a more specific subsection than the other languages, follow that document's local structure rather than forcing uniform placement.
+
+## Validation
+
+- Search for the app name in all target files.
+- 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.
+
+## Scope boundary
+
+- This skill is for repository curation, not for rewriting the 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.
diff --git a/.codex/skills/awesome-mac-maintainer/agents/openai.yaml b/.codex/skills/awesome-mac-maintainer/agents/openai.yaml
new file mode 100644
index 00000000..7ed10434
--- /dev/null
+++ b/.codex/skills/awesome-mac-maintainer/agents/openai.yaml
@@ -0,0 +1,4 @@
+interface:
+ display_name: "Awesome Mac Maintainer"
+ short_description: "Maintain multilingual Awesome Mac listings"
+ default_prompt: "Use $awesome-mac-maintainer to add or update app entries across README.md, README-zh.md, README-ja.md, and README-ko.md while preserving style and ordering."
diff --git a/.codex/skills/awesome-mac-maintainer/references/supported-files.md b/.codex/skills/awesome-mac-maintainer/references/supported-files.md
new file mode 100644
index 00000000..a9d9005d
--- /dev/null
+++ b/.codex/skills/awesome-mac-maintainer/references/supported-files.md
@@ -0,0 +1,41 @@
+# Supported Files
+
+This skill is primarily for the repository's multilingual app listings.
+
+## Default targets
+
+- `README.md`
+- `README-zh.md`
+- `README-ja.md`
+- `README-ko.md`
+
+These are the default files for app additions, removals, description updates, and category moves unless the user explicitly asks to touch a different document set.
+
+## Working assumptions
+
+- The four README files are related, but their local section structure may differ.
+- English placement does not guarantee identical placement in Chinese, Japanese, or Korean.
+- When local structure differs, preserve the established structure in each file.
+
+## Included work
+
+- Add a new app listing.
+- Update an existing listing description.
+- Reclassify an app into a better category.
+- Normalize link and icon formatting for the touched entry.
+
+## Excluded by default
+
+- `command-line-apps.md`
+- `command-line-apps-zh.md`
+- `command-line-apps-ja.md`
+- `command-line-apps-ko.md`
+- `editor-plugin.md`
+- `editor-plugin-zh.md`
+- `editor-plugin-ja.md`
+
+Do not touch these files unless the user explicitly asks for them.
+
+## Placement rule
+
+Use the closest comparable apps already present in the target section as the primary signal for where a new entry belongs.
diff --git a/.github/ISSUE_TEMPLATE/NEW_ADDITION_TO_LIST.yml b/.github/ISSUE_TEMPLATE/NEW_ADDITION_TO_LIST.yml
index cd79bce7..663509c1 100644
--- a/.github/ISSUE_TEMPLATE/NEW_ADDITION_TO_LIST.yml
+++ b/.github/ISSUE_TEMPLATE/NEW_ADDITION_TO_LIST.yml
@@ -7,6 +7,8 @@ body:
attributes:
value: |
NOTE: Each discrete (stand-alone) request should be in its own issue.
+
+ If you plan to open a PR with AI assistance, prefer the repository skill `.codex/skills/awesome-mac-maintainer` to keep category selection, ordering, and multilingual updates consistent.
- type: textarea
attributes:
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index 0542eb31..15568a41 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -23,6 +23,31 @@ Please ensure your pull request adheres to the following guidelines:
- The pull request and commit should have a useful title.
- Annotate your PR to clarify what you did if the diff is confusing.
+### AI-assisted contributions
+
+AI-assisted contributions are welcome, but they should follow the same repository rules as manual edits.
+
+This repository includes a Codex skill at `.codex/skills/awesome-mac-maintainer` for multilingual curation tasks. If you use Codex or a compatible agent, prefer `$awesome-mac-maintainer` when adding, updating, or reclassifying app entries.
+
+The skill is designed to help contributors:
+
+- choose the most appropriate category based on comparable existing entries
+- keep descriptions concise and limited to one sentence
+- sync entries across `README.md`, `README-zh.md`, `README-ja.md`, and `README-ko.md`
+- preserve local section structure, alphabetical ordering, and existing icon style
+
+Example prompts:
+
+```text
+Use $awesome-mac-maintainer to add this app to README.md, README-zh.md, README-ja.md, and README-ko.md.
+```
+
+```text
+Use $awesome-mac-maintainer to check whether this app belongs in Screen Recording or Screenshot Tools, then update the four README files.
+```
+
+If you use AI without this skill, please still make sure the final PR follows the repository's category, ordering, wording, and multilingual sync rules.
+
Thank you for your suggestions!
## How to add to this list