@frontmcp/skills 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/catalog/frontmcp-config/SKILL.md +5 -5
- package/catalog/frontmcp-config/references/configure-deployment-targets.md +84 -1
- package/catalog/frontmcp-config/references/configure-http.md +57 -2
- package/catalog/frontmcp-config/references/configure-session.md +14 -7
- package/catalog/frontmcp-deployment/SKILL.md +3 -3
- package/catalog/frontmcp-deployment/references/build-for-mcpb.md +1 -1
- package/catalog/frontmcp-deployment/references/mcp-client-integration.md +107 -0
- package/catalog/frontmcp-development/SKILL.md +7 -7
- package/catalog/frontmcp-development/examples/create-provider/basic-database-provider.md +14 -0
- package/catalog/frontmcp-development/examples/create-provider/config-and-api-providers.md +85 -9
- package/catalog/frontmcp-development/examples/create-tool/basic-class-tool.md +30 -11
- package/catalog/frontmcp-development/examples/create-tool/tool-with-di-and-errors.md +62 -14
- package/catalog/frontmcp-development/examples/create-tool/tool-with-rate-limiting-and-progress.md +30 -12
- package/catalog/frontmcp-development/references/create-job.md +45 -11
- package/catalog/frontmcp-development/references/create-provider.md +80 -8
- package/catalog/frontmcp-development/references/create-skill-with-tools.md +31 -0
- package/catalog/frontmcp-development/references/create-skill.md +45 -0
- package/catalog/frontmcp-development/references/create-tool.md +124 -46
- package/catalog/frontmcp-guides/SKILL.md +7 -7
- package/catalog/frontmcp-observability/SKILL.md +15 -7
- package/catalog/frontmcp-observability/examples/metrics-endpoint/enable-metrics-endpoint.md +77 -0
- package/catalog/frontmcp-observability/references/metrics-endpoint.md +161 -0
- package/catalog/frontmcp-setup/SKILL.md +11 -11
- package/catalog/frontmcp-setup/examples/frontmcp-skills-usage/install-and-search-skills.md +19 -1
- package/catalog/frontmcp-setup/references/frontmcp-skills-usage.md +260 -19
- package/catalog/frontmcp-setup/references/setup-project.md +29 -0
- package/catalog/frontmcp-setup/references/setup-sqlite.md +68 -9
- package/catalog/frontmcp-testing/SKILL.md +17 -17
- package/catalog/skills-manifest.json +32 -6
- package/package.json +1 -1
|
@@ -1170,12 +1170,14 @@
|
|
|
1170
1170
|
},
|
|
1171
1171
|
{
|
|
1172
1172
|
"name": "config-and-api-providers",
|
|
1173
|
-
"description": "A configuration provider
|
|
1173
|
+
"description": "A configuration provider and an HTTP API client provider, organized as one folder per provider with co-located specs and barrels.",
|
|
1174
1174
|
"level": "intermediate",
|
|
1175
1175
|
"tags": ["development", "provider", "config", "api", "providers"],
|
|
1176
1176
|
"features": [
|
|
1177
1177
|
"A configuration provider using `readonly` properties from environment variables (sync construction)",
|
|
1178
1178
|
"An API client provider that reads credentials in the constructor (no `onInit` — `@Provider` has no lifecycle hooks)",
|
|
1179
|
+
"Folder-per-provider layout (`src/apps/main/providers/<slug>/`) with a barrel `index.ts` and a co-located `.provider.spec.ts`",
|
|
1180
|
+
"Top-level `src/apps/main/providers/index.ts` barrel re-exporting each provider folder",
|
|
1179
1181
|
"Registering providers at `@FrontMcp` level for server-wide sharing across all apps",
|
|
1180
1182
|
"Separating token definitions from provider implementations for clean dependency boundaries"
|
|
1181
1183
|
]
|
|
@@ -1393,31 +1395,35 @@
|
|
|
1393
1395
|
"examples": [
|
|
1394
1396
|
{
|
|
1395
1397
|
"name": "basic-class-tool",
|
|
1396
|
-
"description": "A minimal tool using the class-based pattern with Zod input validation and
|
|
1398
|
+
"description": "A minimal tool using the class-based pattern with Zod input validation, output schema, and types derived from the schemas.",
|
|
1397
1399
|
"level": "basic",
|
|
1398
1400
|
"tags": ["development", "tool", "class"],
|
|
1399
1401
|
"features": [
|
|
1400
1402
|
"Extending `ToolContext` and implementing the `execute()` method",
|
|
1401
1403
|
"Using a Zod raw shape for `inputSchema` (not wrapped in `z.object()`)",
|
|
1402
1404
|
"Defining `outputSchema` to validate and restrict output fields",
|
|
1405
|
+
"Deriving `execute()` input/output types from the schemas via `ToolInputOf<>` / `ToolOutputOf<>` (no duplicated annotation)",
|
|
1406
|
+
"Co-locating schema and tool in sibling files (`<name>.schema.ts` / `<name>.tool.ts`)",
|
|
1403
1407
|
"Registering the tool in an `@App` via the `tools` array"
|
|
1404
1408
|
]
|
|
1405
1409
|
},
|
|
1406
1410
|
{
|
|
1407
1411
|
"name": "tool-with-di-and-errors",
|
|
1408
|
-
"description": "A tool that resolves a database service via DI and uses `this.fail()` for business-logic errors.",
|
|
1412
|
+
"description": "A tool that resolves a database service via DI and uses `this.fail()` for business-logic errors, with `execute()` types derived from the schemas.",
|
|
1409
1413
|
"level": "intermediate",
|
|
1410
1414
|
"tags": ["development", "database", "tool", "di", "errors"],
|
|
1411
1415
|
"features": [
|
|
1412
1416
|
"Defining a typed DI token with `Token<T>` and resolving it via `this.get()`",
|
|
1413
1417
|
"Using `this.fail()` with `ResourceNotFoundError` for MCP-compliant error responses",
|
|
1414
1418
|
"Letting infrastructure errors (database failures) propagate naturally to the framework",
|
|
1419
|
+
"Deriving `execute()` types from `inputSchema` / `outputSchema` via `ToolInputOf<>` / `ToolOutputOf<>`",
|
|
1420
|
+
"Folder-per-tool layout (`tools/delete-record/{schema,tool,index}.ts`) for tools with local helpers or error types",
|
|
1415
1421
|
"Registering both the provider and tool in the same `@App`"
|
|
1416
1422
|
]
|
|
1417
1423
|
},
|
|
1418
1424
|
{
|
|
1419
1425
|
"name": "tool-with-rate-limiting-and-progress",
|
|
1420
|
-
"description": "A batch processing tool that uses rate limiting, concurrency control, progress notifications, and annotations.",
|
|
1426
|
+
"description": "A batch processing tool that uses rate limiting, concurrency control, progress notifications, and annotations, with `execute()` types derived from the schemas.",
|
|
1421
1427
|
"level": "advanced",
|
|
1422
1428
|
"tags": ["development", "throttle", "tool", "rate", "limiting", "progress"],
|
|
1423
1429
|
"features": [
|
|
@@ -1425,7 +1431,8 @@
|
|
|
1425
1431
|
"Sending progress updates to the client with `this.progress(progress, total, message?)`",
|
|
1426
1432
|
"Using `this.mark(stage)` for execution stage tracking and debugging",
|
|
1427
1433
|
"Sending log-level notifications with `this.notify(message, level)`",
|
|
1428
|
-
"Setting tool `annotations` to communicate behavioral hints to clients"
|
|
1434
|
+
"Setting tool `annotations` to communicate behavioral hints to clients",
|
|
1435
|
+
"Deriving `execute()` types from the schemas via `ToolInputOf<>` / `ToolOutputOf<>`"
|
|
1429
1436
|
]
|
|
1430
1437
|
}
|
|
1431
1438
|
]
|
|
@@ -2356,11 +2363,13 @@
|
|
|
2356
2363
|
"name": "install-and-search-skills",
|
|
2357
2364
|
"description": "Install skills statically for Claude Code and use dynamic CLI search for on-demand discovery.",
|
|
2358
2365
|
"level": "basic",
|
|
2359
|
-
"tags": ["setup", "cli", "anthropic", "skills", "usage", "install"],
|
|
2366
|
+
"tags": ["setup", "cli", "anthropic", "skills", "usage", "install", "bulk", "export"],
|
|
2360
2367
|
"features": [
|
|
2361
2368
|
"`frontmcp skills list` and `search` for discovering available skills",
|
|
2362
2369
|
"`frontmcp skills read` for viewing skill content and references on demand",
|
|
2363
2370
|
"`frontmcp skills install --provider claude` for static installation to `.claude/skills/`",
|
|
2371
|
+
"`frontmcp skills install --all` / `--category` / `--tag` for bulk install in one command",
|
|
2372
|
+
"`frontmcp skills export` to ship a skill to Cursor / Windsurf / Copilot rule files",
|
|
2364
2373
|
"Installed skills are auto-loaded by Claude Code in its system prompt context"
|
|
2365
2374
|
]
|
|
2366
2375
|
}
|
|
@@ -3096,6 +3105,23 @@
|
|
|
3096
3105
|
}
|
|
3097
3106
|
]
|
|
3098
3107
|
},
|
|
3108
|
+
{
|
|
3109
|
+
"name": "metrics-endpoint",
|
|
3110
|
+
"description": "Configure the off-by-default /metrics endpoint that exposes process metrics and framework counters in Prometheus text format",
|
|
3111
|
+
"examples": [
|
|
3112
|
+
{
|
|
3113
|
+
"name": "enable-metrics-endpoint",
|
|
3114
|
+
"description": "Turn on the /metrics endpoint with defaults and scrape it with curl.",
|
|
3115
|
+
"level": "basic",
|
|
3116
|
+
"tags": ["observability", "metrics", "prometheus"],
|
|
3117
|
+
"features": [
|
|
3118
|
+
"Setting `metrics: { enabled: true }` on `@FrontMcp` to register `GET /metrics`",
|
|
3119
|
+
"Verifying the Prometheus text-exposition response with `curl`",
|
|
3120
|
+
"Reading process metrics + framework counters from a single scrape"
|
|
3121
|
+
]
|
|
3122
|
+
}
|
|
3123
|
+
]
|
|
3124
|
+
},
|
|
3099
3125
|
{
|
|
3100
3126
|
"name": "vendor-integrations",
|
|
3101
3127
|
"description": "Connect FrontMCP observability to Coralogix, Datadog, Logz.io, Grafana Cloud, or any OTLP backend.",
|