useful-skills

Useful Skills

Personal skill collection for frontend development, Korean writing, Korean research, and practical Korean utilities.

This repository is organized so it can be cloned on a new machine, registered as a marketplace where supported, and installed as one bundle.

Quick Install For AI Agents

If you are an AI agent helping install this repository, use this decision tree.

1. Confirm the current directory is the repository root. It must contain:

   • .agents/plugins/marketplace.json
   • .claude-plugin/marketplace.json
   • plugins/useful-skills/.codex-plugin/plugin.json
   • plugins/useful-skills/skills/

2. If the user is using Codex, register the Codex plugin marketplace:

   codex plugin marketplace add .
   

   Then install the plugin:

   codex plugin add useful-skills@personal
   

3. If the user is using Claude Code, run these commands inside Claude Code:

   /plugin marketplace add .claude-plugin
   /plugin install useful-skills@useful-skills
   

4. If the user is using Gemini CLI, use the shared skills installer:

   npx --yes skills add . --agent gemini-cli --skill '*' -g
   

5. If the user wants the same skills installed into Codex, Claude Code, and Gemini CLI through the shared installer, run:

   npx --yes skills add . --agent codex --agent claude-code --agent gemini-cli --skill '*' -g
   

After installation, verify that humanize-korean, vercel-react-best-practices, and korean-character-count are visible in the target agent. These three cover different source groups and make a good smoke check.

Repository Layout

.
├── .agents/plugins/marketplace.json              # Codex marketplace entry
├── .claude-plugin/marketplace.json               # Claude Code marketplace entry
├── plugins/useful-skills/.codex-plugin/plugin.json
├── plugins/useful-skills/skills/                 # Installed skill bundle
├── skills.sh.json                                # skills CLI grouping metadata
├── docs/license-audit.md
└── third-party-licenses/

Current Bundle

The current bundle includes:

• vercel-react-best-practices - React and Next.js performance patterns.
• vercel-composition-patterns - Scalable React component composition.
• web-design-guidelines - UI, accessibility, and UX review workflow.
• vercel-react-view-transitions - React View Transition API guidance.
• deploy-to-vercel - Preview deployment workflow.
• vercel-optimize - Vercel cost/performance audit workflow.
• tdd - Test-first development loop.
• diagnose - Debugging and performance diagnosis loop.
• prototype - Throwaway UI or logic prototyping workflow.
• improve-codebase-architecture - Architecture review and refactoring workflow.
• zoom-out - Higher-level codebase orientation.
• to-prd - Convert current context into a product requirements doc.
• humanize-korean - Korean AI-text humanizer fast path.
• korean-spell-check - Korean proofreading workflow.
• korean-character-count - Deterministic Korean character/byte counting.
• korean-slang-writing - Korean slang/style candidate lookup for casual writing.
• geeknews-search - GeekNews lookup and search.
• naver-news-search - Korean news search via k-skill proxy.
• naver-blog-research - Naver blog search/read/image workflow.
• naver-shopping-search - Naver Shopping product/price research.
• danawa-price-search - Danawa price comparison workflow.
• korean-privacy-terms - Korean privacy policy/terms/cookie UI wrapper for Next.js projects.
• korea-weather - Korean weather lookup.
• fine-dust-location - Korean air-quality lookup.
• seoul-subway-arrival - Seoul subway arrival lookup.
• seoul-bike - Seoul Bike station lookup.
• delivery-tracking - Korean parcel tracking.
• lotto-results - Korean Lotto draw/match lookup.
• hwp - HWP/HWPX read/convert workflow.

Install After Clone

Codex Plugin

From the repository root:

codex plugin marketplace add .

Then install useful-skills:

codex plugin add useful-skills@personal

The local marketplace file is:

.agents/plugins/marketplace.json

The plugin is:

plugins/useful-skills

Claude Code Plugin

From a Claude Code session in the repository root:

/plugin marketplace add .claude-plugin
/plugin install useful-skills@useful-skills

This uses:

.claude-plugin/marketplace.json

Skills CLI For Codex, Claude Code, And Gemini

For agents that use the shared skills installer, install from the repo path:

npx --yes skills add . --agent codex --agent claude-code --agent gemini-cli --skill '*' -g

Expected global targets:

• Codex: ~/.codex/skills/
• Claude Code: ~/.claude/skills/
• Gemini CLI: ~/.gemini/skills/

Use this path for Gemini. Gemini CLI supports skills installation through the shared skills ecosystem; this repo does not define a separate Gemini plugin marketplace.