vercel-labs
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 16 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vercel-labs/nostics with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vercel-labs/nostics'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/vercel-labs--logs-sdk)HTML
<a href="/listings/vercel-labs--logs-sdk"><img src="/api/listings/vercel-labs--logs-sdk/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
pnpm add nostics
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 18 lines
- {
- "name": "vercel-labs",
- "owner": {
- "name": "Eduardo San Martin Morote"
- },
- "plugins": [
- {
- "name": "nostics",
- "source": "./",
- "description": "Claude Code plugin for nostics: structured diagnostic codes for JavaScript/TypeScript libraries and frameworks",
- "version": "1.4.0",
- "author": {
- "name": "Eduardo San Martin Morote"
- },
- "skills": ["./skills/nostics", "./skills/add-diagnostic"]
- }
- ]
- }
README.md · README · 142 lines
- <p align="center">
- <img src="./docs/public/nostics.svg" alt="nostics" width="320">
- </p>
- # nostics
- [](https://npmx.dev/nostics)
- [](https://npmx.dev/nostics)
- [](https://github.com/vercel-labs/nostics/actions/workflows/ci.yml)
- [](https://bundlejs.com/?q=nostics&treeshake=%5B%7B+defineDiagnostics+%7D%5D)
- Errors worth reading.
- `nostics` helps you replace ad hoc error strings with stable diagnostic codes, actionable fixes, source locations, and docs links.
- ```txt
- [NUXT_B2011] Plugin `./runtime/analytics.server.ts` is server-only but was registered with mode `client`.
- ├▶ fix: Rename the file or register it with mode `server`.
- ├▶ sources: modules/analytics.ts:18:5
- ╰▶ see: https://nuxt.com/e/b2011
- ```
- ## Install
- ```bash
- pnpm add nostics
- ```
- ## Quick start
- ```ts
- import { createConsoleReporter, defineDiagnostics } from 'nostics'
- export const diagnostics = defineDiagnostics({
- docsBase: (code) => `https://nuxt.com/e/${code.replace('NUXT_', '').toLowerCase()}`,
- reporters: [createConsoleReporter()],
- codes: {
- NUXT_B2011: {
- why: (p: { src: string; mode: 'client' | 'server' }) => {
- const expected = p.mode === 'client' ? 'server' : 'client'
- return `Plugin "${p.src}" is ${expected}-only but was registered with mode "${p.mode}".`
- },
- fix: (p: { mode: 'client' | 'server' }) => {
- const expected = p.mode === 'client' ? 'server' : 'client'
- return `Rename the file or register it with mode "${expected}".`
- },
- },
- NUXT_B5001: {
- why: (p: { value: string; configPath: string }) =>
- `Invalid compatibilityDate "${p.value}" in ${p.configPath}.`,
- fix: (p: { example: string }) => `Use an ISO date like "${p.example}", or "latest".`,
- },
- },
- })
- ```
- Use the generated handles where the problem happens:
- ```ts
- const plugin = resolvePlugin()
- const source = locatePluginCall(plugin)
- const config = loadNuxtConfig()
- diagnostics.NUXT_B2011({
- src: plugin.src,
- mode: plugin.mode,
- sources: [source],
- })
- throw diagnostics.NUXT_B5001({
- configPath: config.filepath,
- value: config.compatibilityDate,
- example: '2024-04-03',
- })
- ```
- Calling a handle reports the diagnostic and returns a `Diagnostic`. Throwing the return value raises it. The params are inferred from your `why` and `fix` functions.
- ## Claude Code plugin
- Install the plugin to give Claude skills for your diagnostic catalog:
- ```bash
- claude plugin add https://github.com/vercel-labs/nostics
- ```
- Claude will automatically pick up the `nostics` API reference and an `add-diagnostic` skill that finds the right catalog, chooses the next free code, and wires the call site.
- ## Agent skills
- Prefer just the skills, without the plugin? Install them with [`npx skills`](https://github.com/vercel-labs/skills) into any supported agent (Claude Code, Codex, Cursor, opencode, and more):
- ```bash
- npx skills add vercel-labs/nostics
- ```
- ## Why use it
- - Stable codes that users can search and docs can link to.
- - Typed params at the call site.
- - `Diagnostic` instances that extend `Error`.
- - Built-in console, file, fetch, and Vite dev reporters.
- - Plain, ANSI, and JSON formatters.
- - A build plugin that strips report-only diagnostics from production bundles.
- The structured shape also makes diagnostics easier for tools and coding agents to read, without making that the main workflow.
- ## Vite plugins
- Build-time plugins live in the separate [`@nostics/unplugin`](./packages/unplugin) package:
- ```bash
- pnpm add -D @nostics/unplugin
- ```
- For library builds, use the strip plugin:
- ```ts
- import { nosticsStrip } from '@nostics/unplugin/strip-transform'
- export default defineConfig({
- plugins: [nosticsStrip.vite()],
- })
- ```
- For browser diagnostics during Vite dev, use `createDevReporter()` in the browser and `nosticsCollector` in the consuming app:
- ```ts
- import { nosticsCollector } from '@nostics/unplugin/dev-server-collector'
- export default defineConfig({
- plugins: [nosticsCollector.vite()],
- })
- ```
- ## Docs
- See the docs site for the guide, production build notes, dev collector setup, and API reference.
- ## License
- [MIT](./LICENSE)
install.sh · Bundled script · 34 lines · 1 finding marked
- #!/usr/bin/env bash
- #
- # nostics Claude Code Plugin Installer
- #
- # Adds the repo as a marketplace and installs the plugin project-scoped.
- # Run from your project root — the plugin is scoped to $PWD.
- #
- # Usage: gh api repos/vercel-labs/nostics/contents/install.sh --jq '.content' | base64 -d | bash
- Note: Runs a script fetched from GitHub's contents API (base64-decoded into a shell)
- Line 8 on GitHub
- #
- set -e
- PLUGIN_NAME="nostics"
- MARKETPLACE_NAME="vercel-labs"
- REPO="vercel-labs/nostics"
- echo "nostics Claude Code Plugin Installer"
- echo ""
- # Add the marketplace (skip if already registered)
- if claude plugin marketplace list 2>/dev/null | grep -q " $MARKETPLACE_NAME$"; then
- echo "-> Updating marketplace..."
- claude plugin marketplace update "$MARKETPLACE_NAME"
- else
- echo "-> Adding marketplace..."
- claude plugin marketplace add "$REPO" --scope project
- fi
- # Install the plugin project-scoped (auto-enables)
- echo "-> Installing plugin..."
- claude plugin install "${PLUGIN_NAME}@${MARKETPLACE_NAME}" --scope project
- echo ""
- echo "Installed successfully! Restart Claude Code for the plugin to take effect."
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.