@modootoday/pmcp 0.13.0 → 0.14.0

package/plugins/smol-toml-1/skills/smol-toml/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: smol-toml
+description: Read and serialize TOML configuration with smol-toml 1, including nested tables, parse diagnostics and explicit large-integer preservation. Use for TOML data workflows, not byte-preserving source editing or a schema validator.
+---
+
+# smol-toml 1 configuration data
+
+Read the installed version before applying options from current upstream docs.
+The fixture targets smol-toml 1.8.0; options introduced in 1.9 are outside that
+verified version's contract.
+
+## Parse, validate and serialize
+
+```js
+import { parse, stringify } from "smol-toml";
+
+export function updateHost(source, host) {
+  const settings = parse(source);
+  if (!settings.service || typeof settings.service !== "object") {
+    throw new Error("Missing service table");
+  }
+  settings.service.host = host;
+  return stringify(settings);
+}
+```
+
+Parse errors, including duplicate keys, should be reported rather than replaced
+with empty defaults that lose the original configuration. Validate the parsed
+object against the application's expected shape before using it.
+
+stringify emits TOML data; it does not preserve comments or the original byte
+layout. Do not promise a surgical source edit through parse→stringify. Functions,
+symbols and arbitrary class instances are not ordinary TOML values.
+
+## Preserve the intended value types
+
+JavaScript numbers cannot represent all signed 64-bit TOML integers exactly.
+Use integersAsBigInt when the consumer needs that range:
+
+```js
+const settings = parse("counter = 9223372036854775807", {
+  integersAsBigInt: true,
+});
+```
+
+BigInt affects the application's data contract and cannot be passed directly to
+ordinary JSON.stringify. Preserve integers through TOML serialization or use an
+explicit representation at a JSON boundary. Numbers with no decimal part may
+serialize as integers, so a roundtrip is not a guarantee of original numeric
+spelling.
+
+TOML distinguishes offset datetimes, local datetimes, dates and times. Keep the
+installed package's date representation and the consumer's interpretation
+explicit; converting every value to a local JavaScript date changes semantics.
+
+The fixture verifies nested data roundtrip, duplicate-key rejection and signed
+64-bit integer preservation. It does not establish comment-preserving edits or
+all datetime variants.
+
+## Sources
+
+- [smol-toml API, numeric limits and versioned options](https://github.com/squirrelchat/smol-toml)
+- [TOML specification](https://toml.io/en/)

package/plugins/socks-proxy-agent-10/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "socks-proxy-agent-10",
+  "version": "10.0.0",
+  "description": "Use socks-proxy-agent ^10.0.0 to create SOCKS agents for Node HTTP clients and compatible integrations.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/socks-proxy-agent-10/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/socks-proxy-agent-10/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/socks-proxy-agent-10/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "socks-proxy-agent-10", "version": "10.0.0" }

package/plugins/socks-proxy-agent-10/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "socks-proxy-agent-10",
+  "version": "10.0.0",
+  "description": "Use socks-proxy-agent ^10.0.0 to create SOCKS agents for Node HTTP clients and compatible integrations.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/socks-proxy-agent-10/skills/socks-proxy-agent/SKILL.md

@@ -0,0 +1,172 @@
+---
+name: socks-proxy-agent
+description: Use socks-proxy-agent ^10.0.0 to create SOCKS agents for Node HTTP clients and compatible integrations.
+---
+
+Verified against socks-proxy-agent@10.1.0 on 2026-09-08. 3 of 3 examples executed.
+
+# socks-proxy-agent skill
+
+## Version and module requirements
+
+- This skill targets `socks-proxy-agent` `^10.0.0` (published version covered by the research: `10.1.0`).
+- Node.js 20 or newer is required.
+- The package is ESM. Use `import`, not the older CommonJS-oriented examples.
+- The named runtime export is `SocksProxyAgent`. `SocksProxyAgentOptions` is a type export.
+
+## Constructing an agent
+
+The v10 constructor takes a SOCKS URI (or a `URL`) as its first argument and optional options as its second argument:
+
+```ts
+new SocksProxyAgent(uri: string | URL, opts?: SocksProxyAgentOptions)
+```
+
+Use a URI such as:
+
+```text
+socks://username:password@proxy.example.com
+```
+
+Credentials in a URI must be URL-encoded. For example, an `@` in a username is written as `%40`.
+
+The supported protocol strings are:
+
+- `socks`
+- `socks4`
+- `socks4a`
+- `socks5`
+- `socks5h`
+
+`socks` defaults to SOCKS5 with hostname resolution performed by the proxy.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+const agent = new SocksProxyAgent(
+  'socks://your-name%40example.com:secret@proxy.example.com:1080'
+);
+
+assert.deepEqual(SocksProxyAgent.protocols, [
+  'socks',
+  'socks4',
+  'socks4a',
+  'socks5',
+  'socks5h',
+]);
+assert.equal(typeof agent.proxyUrl, 'string');
+assert.equal(agent.proxyUrl, 'socks://your-name%40example.com:secret@proxy.example.com:1080');
+assert.equal(typeof agent.shouldLookup, 'boolean');
+assert.equal(typeof agent.proxy, 'object');
+```
+
+A `URL` object is also accepted:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+const proxyUrl = new URL('socks5h://proxy.example.com:1080');
+const agent = new SocksProxyAgent(proxyUrl);
+
+assert.equal(typeof agent.proxyUrl, 'string');
+assert.equal(agent.proxyUrl, proxyUrl.toString());
+assert.equal(agent.proxy.type, 5);
+assert.equal(agent.shouldLookup, false);
+```
+
+## Options
+
+The second argument can contain SOCKS proxy options, `socketOptions`, and Node HTTP agent options. `socketOptions` is for TCP connection options other than `host` and `port`.
+
+The agent exposes these documented members:
+
+- `shouldLookup: boolean`
+- `proxy: SocksProxy`
+- `proxyUrl: string`
+- `timeout: number | null`
+- `socketOptions: SocksSocketOptions | null`
+- `connect(req, opts): Promise<net.Socket>`
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+const agent = new SocksProxyAgent('socks5h://proxy.example.com:1080', {
+  timeout: 1000,
+  socketOptions: {
+    keepAlive: true,
+  },
+});
+
+assert.equal(agent.timeout, 1000);
+assert.deepEqual(agent.socketOptions, { keepAlive: true });
+assert.equal(agent.proxy.type, 5);
+assert.equal(agent.shouldLookup, false);
+```
+
+## Using the agent with Node HTTP clients
+
+Pass the agent through the built-in HTTP client's `{ agent }` option. The documented HTTPS integration is:
+
+```ts
+import https from 'https';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+const agent = new SocksProxyAgent(
+  'socks://your-name%40gmail.com:abcdef12345124@br41.nordvpn.com'
+);
+
+https.get('https://ipinfo.io', { agent }, (res) => {
+  console.log(res.headers);
+  res.pipe(process.stdout);
+});
+```
+
+That request requires a reachable SOCKS proxy and network access, so it is not used as a standalone validation example here.
+
+The same agent can be supplied to the separately installed `ws` package for WebSocket connections:
+
+```ts
+import WebSocket from 'ws';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+const agent = new SocksProxyAgent(
+  'socks://your-name%40gmail.com:abcdef12345124@br41.nordvpn.com'
+);
+
+const socket = new WebSocket('ws://echo.websocket.events', { agent });
+```
+
+This integration also requires the separate `ws` package and a network connection.
+
+## Common migration mistake
+
+Do not use the v7-era single-object constructor. Older examples commonly show:
+
+```ts
+new SocksProxyAgent(
+  {
+    hostname: 'myproxy.mydomain.com',
+    username: 'proxyUser',
+    password: 'proxyPass',
+  },
+  { timeout: 1000 }
+);
+```
+
+In v10, the first argument must be a `string` or `URL`; put proxy credentials and endpoint information in the SOCKS URI, and pass options as the second argument:
+
+```ts
+new SocksProxyAgent(
+  'socks5://proxyUser:proxyPass@myproxy.mydomain.com:1080',
+  { timeout: 1000 }
+);
+```
+
+Also account for the v10 runtime requirements: Node.js must be 20 or newer, and the package is ESM.
+
+## Not covered
+
+This skill does not cover SOCKS server setup, proxy authentication behavior beyond URI encoding, detailed SOCKS protocol internals, custom socket connection behavior, the complete `http.AgentOptions` or `SocksSocketOptions` type surfaces, or testing live HTTP/WebSocket connections. The HTTP and WebSocket examples require network access and, for WebSockets, the separate `ws` dependency.

package/plugins/string-width-8/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "string-width-8",
+  "version": "8.0.0",
+  "description": "Use string-width ^8.0.0 to calculate the terminal column width of strings, including Unicode, emoji, ANSI escape codes, ambiguous-width characters, tabs, and non-printing grapheme clusters.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/string-width-8/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/string-width-8/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/string-width-8/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "string-width-8", "version": "8.0.0" }

package/plugins/string-width-8/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "string-width-8",
+  "version": "8.0.0",
+  "description": "Use string-width ^8.0.0 to calculate the terminal column width of strings, including Unicode, emoji, ANSI escape codes, ambiguous-width characters, tabs, and non-printing grapheme clusters.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/string-width-8/skills/string-width/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: string-width
+description: Use string-width ^8.0.0 to calculate the terminal column width of strings, including Unicode, emoji, ANSI escape codes, ambiguous-width characters, tabs, and non-printing grapheme clusters.
+---
+
+Verified against string-width@8.2.2 on 2026-09-08. 4 of 4 examples executed.
+
+# string-width
+
+## Runtime and module shape
+
+- This is an ESM package and requires Node.js `>=20`.
+- Import the default export:
+
+```ts
+import stringWidth from 'string-width';
+```
+
+- The v8 API is `stringWidth(string, options?)` and returns a number.
+- Do not use the older/common `require('string-width')` shape. v8 exposes a default ESM export.
+- This package is a standalone function: it does not require a test runner, CLI, framework globals, or a build step.
+
+## Basic width calculation
+
+The result is the number of terminal columns needed to display the string.
+
+- Ordinary characters generally count as one column.
+- Fullwidth characters such as `古` count as two columns.
+- ANSI escape codes do not affect the result by default.
+- Tabs are ignored by design rather than expanded to a tab-stop width.
+- Non-printing grapheme clusters do not contribute to the width.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import stringWidth from 'string-width';
+
+assert.equal(stringWidth('a'), 1);
+assert.equal(stringWidth('hello'), 5);
+assert.equal(stringWidth('古'), 2);
+assert.equal(stringWidth('古a'), 3);
+assert.equal(stringWidth('\t'), 0);
+assert.equal(stringWidth('\n'), 0);
+```
+
+## Options
+
+### `ambiguousIsNarrow`
+
+`ambiguousIsNarrow` defaults to `true`. With the default, East Asian Ambiguous characters count as one column. Set it to `false` to count them as wide.
+
+The middle dot `·` is an example of an ambiguous-width character:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import stringWidth from 'string-width';
+
+assert.equal(stringWidth('·'), 1);
+assert.equal(stringWidth('·', {ambiguousIsNarrow: true}), 1);
+assert.equal(stringWidth('·', {ambiguousIsNarrow: false}), 2);
+```
+
+### `countAnsiEscapeCodes`
+
+ANSI escape codes are excluded by default. Set `countAnsiEscapeCodes: true` when those codes should contribute to the returned width.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import stringWidth from 'string-width';
+
+const styled = '\u001B[1m古\u001B[22m';
+
+assert.equal(stringWidth(styled), 2);
+assert.ok(stringWidth(styled, {countAnsiEscapeCodes: true}) > stringWidth(styled));
+```
+
+## Unicode and grapheme behavior
+
+The v8 implementation segments grapheme clusters and applies emoji-specific width rules before East Asian Width handling. A displayed emoji such as `😀` occupies two columns:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import stringWidth from 'string-width';
+
+assert.equal(stringWidth('😀'), 2);
+assert.equal(stringWidth('a😀古'), 5);
+```
+
+This means do not calculate width by simply using JavaScript `string.length`: surrogate pairs, combined graphemes, emoji, fullwidth characters, and control sequences do not map directly to terminal columns.
+
+## Common mistakes
+
+- **Using `require`:** v8 is ESM-only in its documented package shape. Use a default `import` and run under a Node version satisfying `>=20`.
+- **Treating `string.length` as display width:** use `stringWidth` because fullwidth Unicode characters and emoji can occupy two columns, while controls and ANSI sequences may occupy none.
+- **Assuming ANSI styling changes visual width:** ANSI escape codes are ignored by default. Pass `countAnsiEscapeCodes: true` only when the escape-code characters themselves should be included.
+- **Assuming ambiguous characters are always wide:** the default is narrow (`ambiguousIsNarrow: true`). Set it to `false` for wide treatment.
+- **Expecting tabs to expand to tab stops:** tabs are ignored by this implementation.
+- **Copying the v6 dependency/runtime assumptions:** v8 requires Node `>=20` and uses the v8 ESM export shape. The older v6 package supported Node `>=16`, which is not the v8 requirement.
+
+## Not covered
+
+This skill does not cover terminal-specific rendering differences, custom tab-stop calculations, layout or padding APIs, ANSI code generation, or behavior outside the documented v8 options and string-width calculation.