find-example
Find the runnable examples and tutorials that demonstrate a Membrane interceptor or config element, given its XML name (the @MCElement value), e.g. "is there an example for <call>?", "which tutorials use the rewriter?", "show me examples of apiKey". Use whenever the user wants to locate existing examples or tutorials under distribution/examples or distribution/tutorials for a given element / plugin / interceptor, or asks whether one has any. This is the usage-finding counterpart to find-interceptor-impl (which finds the Java class).
ソース情報
- リポジトリ
- membrane/api-gateway
- ソースの最終更新活動
- 2026年10月7日 06:33
- 検出された SKILL.md の言語
- 英語
- スター
- 645
- フォーク
- 182
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
ファイルエクスプローラー
2 ファイルSKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- find-example
- description
- Find the runnable examples and tutorials that demonstrate a Membrane interceptor or config element, given its XML name (the @MCElement value), e.g. "is there an example for <call>?", "which tutorials use the rewriter?", "show me examples of apiKey". Use whenever the user wants to locate existing examples or tutorials under distribution/examples or distribution/tutorials for a given element / plugin / interceptor, or asks whether one has any. This is the usage-finding counterpart to find-interceptor-impl (which finds the Java class).
# Find Examples and Tutorials
Membrane ships runnable demos in two trees:
- `distribution/examples/<category>/<name>/` — a self-contained example, usually
with a `proxies.xml` and/or `apis.yaml` config plus a `README.md`.
- `distribution/tutorials/<category>/NN-Title.yaml` — numbered, self-teaching
tutorial steps (one YAML file each).
An element appears in these as a config tag — `<call .../>` in XML or `- call:`
in YAML. This skill greps both trees for that tag and reports where the element
is actually used (not just mentioned in prose). It's the inverse of
`find-interceptor-impl`: that maps a name to its Java class, this maps a name to
its demos.
## Usage
Run the helper with the element name (the `@MCElement(name = "...")` value):
```bash
.claude/skills/find-example/find-example.sh rateLimiter
```
It lists example **directories** (with the first line of each README as a
summary) and tutorial **files**:
```
Examples using <rateLimiter>:
distribution/examples/rate-limiting The `rateLimiter` helps you maintain ...
distribution/examples/xml/namespaces Namespaces are a powerful XML feature ...
Tutorials using <rateLimiter>:
distribution/tutorials/operation/70-Production-Settings.yaml
```
Narrow to one tree when that's all the user wants:
```bash
.claude/skills/find-example/find-example.sh rewriter --tutorials
.claude/skills/find-example/find-example.sh apiKey --examples
```
## Behaviour to trust
- **Matches config, not prose.** Only `proxies.xml`, `*.yaml` and `*.yml` are
searched, against both the XML (`<name ...>`) and YAML (`name:`) tag forms, so
a README that merely names the element won't produce a false hit.
- **Examples are deduped to their directory**; tutorials are listed per file
(they're individual steps sharing one category directory).
- **No match → exit 3.** Either the element genuinely has no demo, or the name is
off. Confirm the name with `find-interceptor-impl` and retry.
GitHubで見る