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 语言: 英语
星标: 656
Forks: 186

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install only the Agent Skill at https://github.com/membrane/api-gateway/tree/master/.claude/skills/find-example.

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/membrane/api-gateway --skill find-example

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

2 个文件

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 查看

返回搜索返回安装

run-example-test

Run a single distribution example or tutorial integration test (IT) fast, instead of the whole ~6 min example suite. Use when asked to run, verify, or check one example/tutorial test in the api-gateway distribution module.

2026-10-20

create-tutorial

Scaffold a new Membrane API Gateway tutorial in the api-gateway repo — the numbered self-teaching YAML under distribution/tutorials/<category>/, its support files and README links, and the matching auto-discovered integration test. Use whenever the user asks to create, add, write, or scaffold a tutorial (or a tutorial step), even if they only describe the gateway behavior they want to teach and don't say the word "skill" or name the files.

2026-10-13

optimize-interceptor-docs

Rewrite the reference documentation of a Membrane config element so the page generated at membrane-api.io comes out clean, exact, and reference-style. Use whenever the user wants to write, improve, optimize, polish, or review the docs / Javadoc / @description / @yaml example of an interceptor, plugin, or any @MCElement class (e.g. "document the apiKey interceptor", "the rewriter docs are weak", "add a YAML example to <groovy>", "clean up the @description on these attributes"). The deliverable is edits to the Java source's class- and setter-level Javadoc — short prose, a runnable YAML example, a `[] |` syntax sketch, and no XML samples. Reach for this even when the user only describes the element and the doc problem without saying "skill".

2026-09-09

查看这个仓库的全部 Skills

find-example

来源信息

安装方式

用 AI 助手安装

检查来源文件

同仓库更多 Skills

用 AI 助手安装

同仓库更多 Skills