write-discoverable-code

検索しやすいコードの書き方

Agentと人がプレーンテキスト検索で見つけやすい名前・構成・説明を書くための指針です。

AIスキル大辞典による日本語要約
品質評価97/100評価確度:十分
人気度(GitHub Star) 59発掘スコア 85
01

このSkillでできること

  • 検索される識別子を設計する
  • 関数・型・定数・ファイル名を見直す
  • 検索しやすいエラーメッセージやコメントを書く
  • コードの発見性を高める
02

使い方

01
STEP 1

利用者が検索しそうな語を洗い出す

02
STEP 2

識別子とファイル名に具体的な語を使う

03
STEP 3

コメントやエラー文の検索可能性を確認する

04
STEP 4

実際の検索で目的のコードに到達できるか試す

03

Skillのインストール

このGitHubリポジトリにあるSkillを確認し、現在の環境に適した方法でインストールしてください。
インストール後、正常に利用できることを確認し、基本的な使い方も簡潔に説明してください。

Repository:
https://github.com/modem-dev/skills
手動でインストールする

README / SKILL.mdから機械抽出できたコマンドのみ表示しています。推測したコマンドではありません。

cp -R write-discoverable-code .cursor/skills/
cp -R write-discoverable-code .claude/skills/
04

このSkillを使うプロンプト例

Skill名を明示すると、意図したSkillを使わせやすくなります。自動発動型では必須とは限りません。

この機能のコードをAgentが検索しやすくなるように、関数名・型名・ファイル名・コメントを見直して。
05

安全性チェック

自動解析による参考情報です。Skillの安全性を保証するものではありません。

外部API通信検出あり
Shellコマンド実行検出あり
ファイル読み取り明確な記述なし
ファイル書き込み検出あり
ネットワークアクセス検出あり
認証情報明確な記述なし
検出根拠を見る
  • shell: py a skill directory into your agent’s skills folder: ```bash # Cursor (project) cp -R write-discoverable-code .cursor/skills/ # Claude Code (project)
  • file_write: our agent’s skills folder: ```bash # Cursor (project) cp -R write-discoverable-code .cursor/skills/ # Claude Code (project) cp -R write-discoverab
  • file_write: overable-code .cursor/skills/ # Claude Code (project) cp -R write-discoverable-code .claude/skills/ ``` Or clone this repo and point your harness
  • network: came from? # Modem skills Agent skills from [Modem](https://modem.dev). ## Skills ### [`write-discoverable-code`](./write-discoverable-code/) Rules
  • network: tilled from Modem’s [How coding agents read your code](https://modem.dev/blog/how-coding-agents-read-your-code) post and the experiments behind it. This
06

関連Skill