fa-mcp-sdk 0.4.54 → 0.4.56

package/cli-template/.claude/skills/{feature-generator → feature-prompt-generator}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: feature-generator
+name: feature-prompt-generator
 description: >-
   Command-only META-SKILL (invoked explicitly, no auto-trigger). Produces an exhaustive,
   self-sufficient prompt for an AI CLI (Claude Code) to implement a feature turnkey.
@@ -11,7 +11,7 @@ argument-hint: "[feature description | path to task file]"
 allowed-tools: Read, Grep, Glob, Bash(git *), Bash(yarn *), Bash(npm *), Bash(node *), Bash(ls *), Bash(cat *)
 ---
 
-# feature-generator — META-SKILL for generating prompts for an AI CLI
+# feature-prompt-generator — META-SKILL for generating prompts for an AI CLI
 
 ## Essence
 
@@ -28,7 +28,7 @@ implementation. You do not touch any code in the target repository.
 ## How to invoke
 
 **Command-only.** The skill is **never auto-invoked by the model** — `disable-model-invocation`
-is set to `true`. Runs solely when the operator explicitly calls it (e.g. `/feature-generator`
+is set to `true`. Runs solely when the operator explicitly calls it (e.g. `/feature-prompt-generator`
 or the equivalent UI invocation). Ignore any implicit triggers from phrasing in user messages.
 
 ## When to use

package/cli-template/.claude/skills/readme-generator/SKILL.md

@@ -167,8 +167,8 @@ Canonical section order. Include only sections backed by actual findings; omit a
     - Impersonation → `readme-docs/impersonation.md`
     - Project-specific: fuzzy resolution, caching strategy, API version detection, batch limits,
       content-format conversion, etc. → `readme-docs/<topic>.md` as appropriate
-13. **Skills** — short paragraph linking to `SKILL_README.md` in repo root (kept at root by
-    convention established in existing fa-mcp-sdk projects)
+13. **Skills** — short paragraph linking to `readme-docs/SKILLS.md` (kept under `readme-docs/`
+    so it is picked up as a satellite and assembled into the `doc://readme` resource)
 14. **Stack** — 4–7 bullets: framework (`fa-mcp-sdk`), transport, language, key libs
 15. **License**
 
@@ -199,12 +199,12 @@ For project-specific capabilities (fuzzy resolution, custom endpoints, etc.) com
 
 Every satellite MD begins with a 1-sentence summary so it stands alone when opened directly.
 
-### Step 6 — Update `SKILL_README.md`
+### Step 6 — Update `readme-docs/SKILLS.md`
 
-If `.claude/skills/` is non-empty, regenerate `SKILL_README.md` in the repository root. Keep the
-existing format (seen in mcp-jira / mcp-wiki): per-skill sections with command, launch mode,
-arguments table, examples. **Do not move this file into `readme-docs/`** — the projects' convention keeps
-it at the root.
+If `.claude/skills/` is non-empty, regenerate `readme-docs/SKILLS.md`. Keep the existing format
+(per-skill sections with command, launch mode, arguments table, examples). The file lives under
+`readme-docs/` so it is included as a satellite in the `doc://readme` assembled document — link
+to it from the main README's **Skills** section.
 
 ### Step 7 — Validate
 
@@ -227,7 +227,7 @@ Run through this checklist before declaring done:
 
 1. `README.md` — restructured per canonical order
 2. `readme-docs/<topic>.md` — one per satellite topic, only those the project needs
-3. `SKILL_README.md` — regenerated if `.claude/skills/` is present
+3. `readme-docs/SKILLS.md` — regenerated if `.claude/skills/` is present
 4. `README.backup.md` — backup of previous README when rewriting
 
 ## References

package/cli-template/.claude/skills/readme-generator/reference/satellite-templates.md

@@ -76,7 +76,7 @@ supply their own identity).
 ## Related
 
 - Admin panel for token generation: [Admin Panel](./admin-panel.md)
-- `/gen-jwt` skill: [SKILL_README.md](../SKILL_README.md)
+- `/gen-jwt` skill: [SKILLS](./SKILLS.md)
 ```
 
 ---
@@ -136,7 +136,7 @@ Response shape:
 ## `/headless-test` skill
 
 Runs intelligent tests against all tools in a controlled scope (project / space / etc.) and writes
-a Markdown report to `claudedocs/test-report-{RUN_ID}.md`. See [SKILL_README.md](../SKILL_README.md).
+a Markdown report to `claudedocs/test-report-{RUN_ID}.md`. See [SKILLS](./SKILLS.md).
 ```
 
 ---

package/cli-template/.claude/skills/readme-generator/reference/templates.md

@@ -357,7 +357,7 @@ The project ships with custom skills in `.claude/skills/`:
 | `/headless-test`    | Run headless tests for all MCP tools via curl API   |
 | `/upgrade-guide`    | Generate migration guide for fa-mcp-sdk upgrades    |
 
-Details, launch modes, and examples: [SKILL_README.md](./SKILL_README.md).
+Details, launch modes, and examples: [SKILLS](./readme-docs/SKILLS.md).
 ```
 
 ---

package/cli-template/README.md

@@ -166,7 +166,7 @@ The project ships with custom skills in `.claude/skills/`:
 |----------------------|-------------------------------------------------------------------------|
 | `/gen-jwt`           | Generate JWT tokens for MCP server authentication                       |
 | `/upgrade-guide`     | Generate migration guide for `fa-mcp-sdk` upgrades                      |
-| `/feature-generator` | Turn a feature description into a self-sufficient prompt for an AI CLI  |
+| `/feature-prompt-generator` | Turn a feature description into a self-sufficient prompt for an AI CLI  |
 | `/readme-generator`  | Generate structured README.md + satellite `readme-docs/*.md`            |
 
 Details, launch modes, and examples: [SKILL_README.md](SKILL_README.md)

package/cli-template/SKILL_README.md

@@ -66,7 +66,7 @@ via `git show <ref>:package.json`. To reference SDK versions/commits directly, m
 
 ---
 
-### `/feature-generator` — Feature Prompt Generator
+### `/feature-prompt-generator` — Feature Prompt Generator
 
 A **META-skill**: turns a feature description into a self-sufficient prompt for an AI CLI (Claude Code or another
 agent) to implement the feature turnkey. The skill itself does NOT write feature code — it produces the prompt.
@@ -83,7 +83,7 @@ What it does:
 
 Characteristics:
 
-- **Launch**: **command-only** via `/feature-generator`. Has `disable-model-invocation: true` — does NOT activate
+- **Launch**: **command-only** via `/feature-prompt-generator`. Has `disable-model-invocation: true` — does NOT activate
   on trigger phrases or implicit mentions
 - **Input**: free-form feature description OR path to a file with the description (e.g. `task.md`, ticket dump)
 - **Output**: file `prop-<kebab-name>.md` in repository root. If the file already exists, a numeric suffix is
@@ -92,10 +92,10 @@ Characteristics:
 **Examples:**
 
 ```
-/feature-generator Add a tool for batch-processing customer records across a project
-/feature-generator task.md
-/feature-generator REQ-1234: implement webhook callback receiver for external events
-/feature-generator Add OAuth2 token refresh logic to the HTTP client
+/feature-prompt-generator Add a tool for batch-processing customer records across a project
+/feature-prompt-generator task.md
+/feature-prompt-generator REQ-1234: implement webhook callback receiver for external events
+/feature-prompt-generator Add OAuth2 token refresh logic to the HTTP client
 ```
 
 ---

package/cli-template/package.json

@@ -50,7 +50,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.1",
-    "fa-mcp-sdk": "^0.4.54"
+    "fa-mcp-sdk": "^0.4.56"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.4.54",
+  "version": "0.4.56",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",