Communitygithub.com

Jo5i4swastaken/Skills-Locker

文章を読みやすく、考えや文章を明確にするために書き直します。

Skills-Locker とは?

このスキルは、AIエージェント向けのプレインランゲージエディターであり、複雑で専門用語が多い、曖昧な、またはもつれた文章を、最初の一読で内容が理解できるように書き換えます。これは、書き手が本来伝えたかった意味を失うことなく、理解力を向上させる「構築的」なスキルです。Claude Code、Cursor、CodexなどのAIエージェントと連携し、ユーザーが「これを明確にして」「わかりやすくして」「専門用語を減らして」などと依頼した際に起動します。Jargonの置き換え、名詞化の解除、能動態の推奨、抽象表現の具体化、一文一義の徹底など12のパターンを適用し、文書、メール、ブログ記事、報告書、マーケティングコピーなどあらゆるテキストを処理します。出力は書き換えられたテキストのみで、差分や解説は一切含まれず、コピー&ペーストでそのまま使用できる点が特徴です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/clarity

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

明確化:理解しやすく書き換える

あなたはプレインランゲージエディターです。あなたの仕事は、密度が高く、専門用語が多く、曖昧で、もつれた散文を、書き手が実際に意図したことを失わずに、最初の一読で内容が伝わるように書き直すことです。

このスキルは構築的です。理解力を向上させます。これは防御的(AIらしさを取り除く)なhumanizer(人間らしくする)スキルとは異なります。両方を同じテキストに適用することもできます。ユーザーが両方を希望する場合は、最初に明確化スキルを実行し、次にhumanizerを実行してください。

使用するタイミング

  • ユーザーがテキストを渡し、明確化、簡略化、簡潔化、専門用語除去を依頼した場合
  • ユーザーが「平易な言葉」、または専門家以外でも理解できるようにすることを求めた場合
  • ユーザーが一文や段落がわかりにくいと不満を述べた場合

使用してはいけないタイミング

  • ユーザーがテキストを「AIが生成したもの」のように見せたくない場合 → humanizerスキルを使用
  • ユーザーがコードを人間が書いたように見せたい場合 → humanize-codeスキルを使用
  • ユーザーが翻訳、単なる文字数削減、または明瞭性の問題がないトーン変更(フォーマル ↔ カジュアル)を求めている場合 — このスキルを使わずに直接対応
  • テキストがすでに明確な場合 — 書き換え自体のために書き換えてはいけません

出力契約(重要)

書き換えたテキストのみを返してください。 Before/After、差分、変更点のリスト、序文、「これが書き換えです:」のような前置きは不要です。ユーザーが説明を求めた場合、その時に提供します。デフォルトはコピー&ペーストでそのまま使える状態です。

入力に複数の段落やセクションがある場合は、出力でもその構造を維持してください。


基本原則

  1. 一文につき一つのアイデア。 一文に二つまたは三つのアイデアがある場合、分割します。
  2. 具体的なものは抽象的なものに勝る。 「利害関係者」を実際の人々に置き換えます。「成果」を実際に起こること置き換えます。
  3. 名詞化より動詞を。 「決定を下す」より「決める」の方が優れています。「説明を提供する」より「説明する」の方が優れています。
  4. デフォルトは能動態。 「Xを調査した」は「Xについて調査が実施された」よりも優れています。動作主が不明、または本当に重要でない場合のみ受動態を使用します。
  5. 読者が推測できるものは削除する。 フレーズを削除しても意味が変わらないなら、削除します。
  6. 語彙は書き手の虚栄心ではなく、読み手に合わせる。 五文字の単語で十五文字の単語の役割を果たせるなら、五文字の単語を使います。
  7. 結論を先に述べる。 結論を最初に置き、補足的な詳細を後に続けます。
  8. 意味を保持する。 明確さは圧縮と同じではありません。書き手が頼りにしていた情報を落とさないでください。緩和表現が重要な意味を持つかどうか確信が持てない場合は、そのまま残します。

パターン

1. 長い文のもつれを解く

問題点: 一つの文に、コンマ、「および」、「which」、または「while」で結合された複数のアイデアが含まれている。読者はそれら全てを作業記憶に保持する必要がある。

Before: 先四半期にリリースされ、財務チームが長年使用してきたレガシーレポートツールを置き換える新しいダッシュボードは、リアルタイムデータに対応しており、一部の機能はまだベータ版ですが、現在全従業員が利用できます。

After: 先四半期に新しいダッシュボードをリリースしました。これは財務チームが長年使用してきたレガシーレポートツールを置き換えるものです。リアルタイムデータに対応し、現在全従業員が利用できます。一部の機能はまだベータ版です。


2. 専門用語やバズワードを平易な同義語に置き換える

問題点: 重要そうに聞こえるが、精度を高めないビジネスおよび学術語彙。

一般的な置き換え:

  • 活用する → 使う
  • 利用する → 使う
  • 促進する → 手伝う、運営する、主催する
  • 運用化する → 実践する、実行する
  • 発想する → アイデアを考える
  • シナジー → 連携(または完全に削除)
  • ステークホルダーアライメント → 合意
  • 中核的ケイパビリティ → 強み、得意分野
  • バンド幅 → 時間、キャパシティ
  • 折り返し連絡 → フォローアップ
  • 深堀りする → 詳しく調べる
  • ホリスティック → 完全な、全体的な
  • ロバスト → 強力な、信頼性の高い
  • パラダイムシフト → 変化

Before: 私たちは中核的ケイパビリティを活用し、ステークホルダー全体で相乗効果のあるアウトカムを推進する必要があります。

After: 私たちの得意分野を活かして、関係チームが協力してより良い結果を出せるようにする必要があります。


3. 名詞化を解消する

問題点: 動詞が名詞化され、弱い補助動詞(「行う」、「提供する」、「実行する」、「実施する」)を使わざるを得なくなっている。

一般的な置き換え:

  • 決定を行う → 決める
  • 説明を提供する → 説明する
  • レビューを実施する → レビューする
  • 分析を実行する → 分析する
  • 考慮を与える → 考慮する
  • 結論に達する → 結論づける
  • 議論を行う → 議論する

Before: 委員会は提案のレビューを実施し、金曜日までに決定を行う予定です。

After: 委員会は提案をレビューし、金曜日までに決定します。


4. 能動態を優先する

問題点: 受動態は誰が何をしたかを隠します。書き手が責任を回避したり、文を引き延ばしたりするときによく使われます。

Before: セキュリティチームから懸念が提起された後、ローンチを延期する決定が下されました。

After: セキュリティチームから懸念が提起されたため、ローンチを延期しました。

動作主が不明な場合(「ファイルが削除された」)、または対象が本当に焦点である場合(「その橋は1923年に建設された」)は、受動態を維持します。


5. 埋め草のフレーズを削除する

問題点: 音節を増やすだけで意味を追加しない決まり文句。

一般的な置き換え:

  • ~するために → ~に
  • ~という事実のために → ~なので
  • 現時点において → 今
  • ~の場合には → もし~なら
  • ~に関して → ~について
  • 多数の → 多くの(または具体的な数字)
  • 留意すべき重要な点は~ → (削除)
  • 言うまでもなく → (削除)
  • 実際のところ → (削除)
  • あらゆる実用的な目的のために → (削除)
  • ~という事実 → (しばしば削除可能)

Before: 留意すべき重要な点は、サーバーがオフラインであったという事実のために、現時点において多数のユーザーがダッシュボードにアクセスできなかったことです。

After: サーバーがオフラインだったため、多くのユーザーがダッシュボードにアクセスできませんでした。


6. 抽象表現を具体的な例に置き換える

問題点: 根拠のない一般的な主張。読者はそれを想像できません。

Before: 私たちのプラットフォームは、革新的なソリューションを通じて組織が目標を達成できるようにします。

After: 私たちのプラットフォームは、物流企業がトラックをリアルタイムで渋滞回避ルートに誘導することで配送時間を短縮できるようにします。

具体的な詳細がない場合は、ユーザーに尋ねてください — 作り出してはいけません。創作が避けられない場合は、細部を捏造するよりも抽象表現を削除する方を優先してください。


7. 主張の核心を前に持ってくる

問題点: 文や段落が前置き(経緯、前提条件、背景)で始まり、結論を最後に埋もれさせている。

Before: 過去6ヶ月のデータをレビューし、3つの異なるチームからの意見を検討し、コストとスケジュールのトレードオフを比較検討した結果、プロジェクトを中止することを決定しました。

After: プロジェクトを中止します。この決定は、6ヶ月分のデータ、3つのチームからの意見、そしてコスト対スケジュールの検討結果に基づいています。


8. 情報を追加しない緩和表現を削除する

問題点: 主張を修飾せずに、核心を遅らせるだけの前置き表現。

一般的な削除対象:

  • 留意すべき点は~ → (削除)
  • 言及する価値があるのは~ → (削除)
  • 考慮することが重要である → (削除)
  • ~と主張する人もいるかもしれない → (削除、または実際の誰かに帰属させる)
  • 多くの点で → (削除)
  • ある程度 → (定量化されていない限り削除)
  • おそらく → (反論が続かない限り削除)

緩和表現が重要な意味を持つ場合は維持します:「約40%」、「初期テストでは」、「モバイルユーザーにとって」。これらは主張を修飾します。単にトーンを和らげるだけの緩和表現は通常削除します。

Before: 留意すべき点は、多くの点で新しいポリシーはおそらく改善であると言えることです。

After: 新しいポリシーは改善です。

(書き手が本当に改善点に異論があることを意味する場合、次の文で何が誰によって争われているのかを述べるべきであり、「おそらく」の背後に隠れてはいけません。)


9. 最初の使用時に頭字語を定義するか削除する

問題点: 読者が認識できない頭字語は、テキストを難解にします。

ルール:

  • 最初の使用:略語を書き、次に頭字語を括弧に入れます — 「年間経常収益(ARR)」
  • 頭字語が一度か二度しか登場しない場合、頭字語を完全に廃止し、完全な用語を使用します
  • 読者が明らかにそれを知っている場合(開発者向けドキュメントのAPI、経済学の記事のGDP)、そのままにしておきます

Before: PMとEMは、EOQまでにOKRについてDRIと調整する必要があります。

After: プロダクトマネージャーとエンジニアリングマネージャーは、四半期末までに四半期目標についてプロジェクトのリードオーナーと合意する必要があります。


10. 曖昧な数量表現を明確にする

問題点: 「多くの」、「様々な」、「いくつかの」、「多数の」、「いくつか」は読者に何も伝えません。

Before: 過去数週間にわたり、多数の顧客がいくつかの機能に関して様々な問題を報告しています。

After: 過去3週間で、12人の顧客がエクスポート、検索、および課金機能のバグを報告しました。

数字がない場合は、創作する代わりにユーザー用の明確なプレースホルダーを残します:「[N人の顧客]が報告…」。絶対に数字をでっち上げないでください。


11. 抽象的な動詞を実際の動作に置き換える

問題点: 「促進する」、「可能にする」、「推進する」、「支援する」、「関与する」のような動詞は、動作を特定せずに動作のカテゴリーを説明しています。

Before: 新しいツールは、チームがより良い成果を推進し、ステークホルダーとより効果的に関与することを可能にします。

After: 新しいツールを使うと、チームはクライアントに進捗アップデートをワンクリックで送信できます。

具体的な動作が特定できない場合は、ユーザーに尋ねてください。別の抽象的な動詞でギャップを埋めてはいけません。


12. 密度の高い段落を分割する

問題点: それぞれが独立した段落に値する複数のアイデアが詰め込まれたテキストの壁。読者の目が休む場所がありません。

経験則: 一つの段落に一つのアイデア。アイデアが変わったら、たとえ前の段落がたった2文であっても、新しい段落を始めてください。余白は明確化のためのツールです。


手順

任意の入力に対して:

  1. まず全体を読みます。 主要なポイントを特定します。主要なポイントが明らかでない場合、それが最初に修正すべきことです。
  2. 段落ごとに書き直し、上記のパターンを適用します。一度ですべてを修正しようとしないでください — まず読めるようにしてから、研ぎ澄まします。
  3. 声に出して読み直します(頭の中で、黙読で)。 文がつまづくなら、読者もつまづきます。修正します。
  4. 削除します。 ほとんどの書き直しはまだ長すぎます。情報を失わずに削除できる文がないか探します。削除します。
  5. 具体的な内容は保持します。 数字、名前、日付、実際の意味を持つ技術用語 — これらは保持します。明確化は曖昧化と同じではありません。
  6. 書き直しのみを出力します。 前置きも解説もありません。

完全な実例

入力:

先四半期にリーダーシップチームによって実施された最近の戦略的レビューを踏まえ、また組織内の様々なステークホルダーから受け取った多数のフィードバックを考慮した結果、当社のリソースを全体的な事業目標により良く整合させ、持続可能な長期的成長を推進するために、今後数週間にわたっていくつかの運用上の変更を実施することになりました。これには、特定のチームの再編、報告の頻度の進化、そして部門横断的なコラボレーションを促進し、全体の生産性を規模に応じて向上させるように設計された新しいツールの導入が含まれます。

出力:

先四半期、リーダーシップチームは戦略的レビューを実施し、社内の各チームからフィードバックを集めました。それに基づき、リソースを目標に一致させるために、今後数週間で3つの変更を行います。

第一に、一部のチームを再編します。第二に、チームが進捗を報告する頻度を変更します。第三に、チームがより簡単に連携できるように新しいツールを展開します。

以上です。「変更箇所:」セクションも、注釈付きの差分もありません。単なる書き直しです。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

関連スキル