@lesliechan721/aw-plugin-core 0.1.0-beta.1

package/dist/portable-skill-validation.js

@@ -0,0 +1,111 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import YAML from 'yaml';
+import { isSkillAuthorOnlyPath } from './skill-authoring.js';
+import { validateSkillFrontmatterCapabilities } from './skill-frontmatter-capabilities.js';
+const SKILL_FILE_PATH = 'SKILL.md';
+const SKILL_OWNER_MARKER = '.agent-workflows-owner.json';
+export function validatePortableSkillName(value, fieldName = 'portable Skill name') {
+    if (value.length > 64 || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(value)) {
+        throw new Error(`Invalid ${fieldName}: expected at most 64 ASCII lowercase hyphen-case characters.`);
+    }
+}
+function comparePaths(left, right) {
+    return Buffer.compare(Buffer.from(left, 'utf8'), Buffer.from(right, 'utf8'));
+}
+function parseFrontmatter(rawContent) {
+    const normalized = rawContent.replace(/\r\n/g, '\n');
+    if (!normalized.startsWith('---\n'))
+        throw new Error('SKILL.md 缺少 YAML frontmatter。');
+    const closingIndex = normalized.indexOf('\n---\n', 4);
+    const closingAtEof = closingIndex === -1 && normalized.endsWith('\n---');
+    if (closingIndex === -1 && !closingAtEof)
+        throw new Error('SKILL.md frontmatter 缺少结束分隔符。');
+    const yamlEndIndex = closingAtEof ? normalized.length - '\n---'.length : closingIndex;
+    let frontmatter;
+    try {
+        frontmatter = YAML.parse(normalized.slice(4, yamlEndIndex));
+    }
+    catch (error) {
+        throw new Error(`SKILL.md frontmatter YAML 解析失败：${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof frontmatter !== 'object' || frontmatter === null || Array.isArray(frontmatter)) {
+        throw new Error('SKILL.md frontmatter 根节点必须是 object。');
+    }
+    return frontmatter;
+}
+async function collectFiles(rootDir) {
+    const files = {};
+    const visit = async (currentDir, parentPath) => {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries.sort((left, right) => comparePaths(left.name, right.name))) {
+            const relativePath = parentPath ? `${parentPath}/${entry.name}` : entry.name;
+            if (isSkillAuthorOnlyPath(relativePath))
+                continue;
+            if (relativePath === SKILL_OWNER_MARKER) {
+                throw new Error(`Skill source tree 不能声明保留文件 ${SKILL_OWNER_MARKER}。`);
+            }
+            const absolutePath = path.join(currentDir, entry.name);
+            if (entry.isSymbolicLink())
+                throw new Error(`Skill 静态源不支持符号链接：${relativePath}`);
+            if (entry.isDirectory()) {
+                await visit(absolutePath, relativePath);
+            }
+            else if (entry.isFile()) {
+                files[relativePath] = await fs.readFile(absolutePath);
+            }
+            else {
+                throw new Error(`Skill 静态源只支持普通文件和目录：${relativePath}`);
+            }
+        }
+    };
+    await visit(rootDir, '');
+    return files;
+}
+export async function validatePortableSkillDirectory(rootDir) {
+    const rootStats = await fs.lstat(rootDir).catch(() => null);
+    if (!rootStats || rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+        throw new Error(`Skill 根路径必须是真实目录：${rootDir}`);
+    }
+    const skillKey = path.basename(rootDir);
+    validatePortableSkillName(skillKey, 'portable Skill directory name');
+    const files = await collectFiles(rootDir);
+    const skillFile = files[SKILL_FILE_PATH];
+    if (!skillFile || skillFile.toString('utf8').trim() === '') {
+        throw new Error(`agent-skills.skill "${skillKey}" 缺少 SKILL.md 内容。`);
+    }
+    const frontmatter = parseFrontmatter(skillFile.toString('utf8'));
+    if (typeof frontmatter.name === 'string')
+        validatePortableSkillName(frontmatter.name, 'SKILL.md frontmatter.name');
+    if (typeof frontmatter.description === 'string' && frontmatter.description.length > 1024) {
+        throw new Error('Invalid SKILL.md frontmatter.description: expected at most 1024 characters.');
+    }
+    const diagnostics = validateSkillFrontmatterCapabilities(frontmatter, 'portable-agent-skills');
+    if (diagnostics.length > 0) {
+        throw new Error(`SKILL.md frontmatter 不符合 portable-agent-skills profile：${diagnostics.map((entry) => `[${entry.code}] ${entry.message}`).join('; ')}`);
+    }
+    if (frontmatter.name !== skillKey) {
+        throw new Error(`SKILL.md frontmatter 的 name 必须与 Skill 目录一致：期望 ${JSON.stringify(skillKey)}。`);
+    }
+    const readme = files['README.md'];
+    if (!readme || readme.toString('utf8').trim() === '') {
+        throw new Error(`agent-skills.skill "${skillKey}" 缺少非空 README.md。`);
+    }
+    return { skillKey, files };
+}
+export async function validatePortableSkillDirectoriesRoot(rootDir) {
+    const rootStats = await fs.lstat(rootDir).catch(() => null);
+    if (!rootStats || rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+        throw new Error(`Skills 根路径必须是真实目录：${rootDir}`);
+    }
+    const entries = await fs.readdir(rootDir, { withFileTypes: true });
+    const trees = [];
+    for (const entry of entries.sort((left, right) => comparePaths(left.name, right.name))) {
+        if (entry.isSymbolicLink() || !entry.isDirectory()) {
+            throw new Error(`Skills 根目录的直接子节点必须是普通目录：${entry.name}`);
+        }
+        trees.push(await validatePortableSkillDirectory(path.join(rootDir, entry.name)));
+    }
+    return trees;
+}
+//# sourceMappingURL=portable-skill-validation.js.map

package/dist/portable-skill-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-skill-validation.js","sourceRoot":"","sources":["../src/portable-skill-validation.ts"],"names":[],"mappings":"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"}

package/dist/read-json.d.ts

@@ -0,0 +1 @@
+export declare function readJsonFile<T>(filePath: string): Promise<T>;

package/dist/read-json.js

@@ -0,0 +1,5 @@
+import fs from 'fs-extra';
+export async function readJsonFile(filePath) {
+    return fs.readJson(filePath);
+}
+//# sourceMappingURL=read-json.js.map

package/dist/read-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-json.js","sourceRoot":"","sources":["../src/read-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAe,CAAC;AAC7C,CAAC"}

package/dist/runtime-export-source.d.ts

@@ -0,0 +1,14 @@
+export declare function isIgnoredPluginInputDirectory(name: string): boolean;
+export declare function assertPluginInputTree(rootDir: string): Promise<string>;
+export interface CanonicalRuntimeSourceIdentity {
+    rootPath: string;
+    rootRealPath: string;
+    relativePath: string;
+    sourceRealPath: string;
+}
+export declare function resolveCanonicalRuntimeSourceIdentity(rootDir: string, relativePath: string, fieldName: string): Promise<CanonicalRuntimeSourceIdentity>;
+export declare function validateRuntimeExportSource(options: {
+    pluginRoot: string;
+    name: string;
+    source: string;
+}): Promise<CanonicalRuntimeSourceIdentity>;

package/dist/runtime-export-source.js

@@ -0,0 +1,73 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+const FORBIDDEN_EXPORT_ROOTS = new Set([
+    '.release', '.tmp', 'build', 'dist', 'evals', 'node_modules', 'reports', 'skills', 'tmp',
+]);
+const AUTHORING_TREE_IGNORED_DIRECTORIES = new Set(['.git', 'node_modules']);
+export function isIgnoredPluginInputDirectory(name) {
+    return AUTHORING_TREE_IGNORED_DIRECTORIES.has(name);
+}
+export async function assertPluginInputTree(rootDir) {
+    const rootPath = path.resolve(rootDir);
+    const rootStats = await fs.lstat(rootPath);
+    if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+        throw new Error('Invalid plugin input tree: plugin root must be a regular directory.');
+    }
+    const rootRealPath = await fs.realpath(rootPath);
+    const walk = async (directory, relativeRoot = '') => {
+        for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+            const relativePath = relativeRoot
+                ? path.posix.join(relativeRoot, entry.name)
+                : entry.name;
+            if (entry.isDirectory() && isIgnoredPluginInputDirectory(entry.name))
+                continue;
+            if (entry.isSymbolicLink()) {
+                throw new Error(`Invalid plugin input tree: symbolic links are not supported (${relativePath}).`);
+            }
+            if (entry.isDirectory()) {
+                await walk(path.join(directory, entry.name), relativePath);
+            }
+            else if (!entry.isFile()) {
+                throw new Error(`Invalid plugin input tree: only regular files and directories are supported (${relativePath}).`);
+            }
+        }
+    };
+    await walk(rootRealPath);
+    return rootRealPath;
+}
+export async function resolveCanonicalRuntimeSourceIdentity(rootDir, relativePath, fieldName) {
+    const rootPath = path.resolve(rootDir);
+    const rootStats = await fs.lstat(rootPath);
+    if (rootStats.isSymbolicLink() || !rootStats.isDirectory()) {
+        throw new Error(`Invalid ${fieldName}: source root must be a regular directory.`);
+    }
+    const rootRealPath = await fs.realpath(rootPath);
+    const segments = relativePath.replace(/^\.\//u, '').split('/');
+    let current = rootRealPath;
+    for (const [index, segment] of segments.entries()) {
+        current = path.join(current, segment);
+        const stats = await fs.lstat(current).catch(() => undefined);
+        if (!stats)
+            throw new Error(`Invalid ${fieldName}: missing file "${relativePath}".`);
+        if (stats.isSymbolicLink()) {
+            throw new Error(`Invalid ${fieldName}: symbolic links are not supported (${relativePath}).`);
+        }
+        if (index < segments.length - 1 && !stats.isDirectory()) {
+            throw new Error(`Invalid ${fieldName}: path parent is not a directory (${relativePath}).`);
+        }
+        if (index === segments.length - 1 && !stats.isFile()) {
+            throw new Error(`Invalid ${fieldName}: expected a regular file (${relativePath}).`);
+        }
+    }
+    return { rootPath, rootRealPath, relativePath, sourceRealPath: await fs.realpath(current) };
+}
+export async function validateRuntimeExportSource(options) {
+    const normalizedSource = options.source.replace(/^\.\//u, '');
+    const forbiddenSegment = normalizedSource.split('/').find((segment) => FORBIDDEN_EXPORT_ROOTS.has(segment));
+    if (forbiddenSegment) {
+        throw new Error(`Invalid buildConfig.runtimeExports export "${options.name}": source must not be below ${forbiddenSegment}/.`);
+    }
+    const fieldName = `buildConfig.runtimeExports export "${options.name}"`;
+    return resolveCanonicalRuntimeSourceIdentity(options.pluginRoot, options.source, fieldName);
+}
+//# sourceMappingURL=runtime-export-source.js.map

package/dist/runtime-export-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-export-source.js","sourceRoot":"","sources":["../src/runtime-export-source.ts"],"names":[],"mappings":"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"}

package/dist/skill-authoring.d.ts

@@ -0,0 +1,2 @@
+export declare function isSkillAuthorOnlyPath(relativePath: string): boolean;
+export declare function isSkillCollectionAuthorOnlyPath(relativePath: string): boolean;

package/dist/skill-authoring.js

@@ -0,0 +1,13 @@
+const SKILL_AUTHOR_ONLY_DIRECTORIES = new Set(['evals', 'reports']);
+function pathSegments(relativePath) {
+    return relativePath.split(/[\\/]/u).filter(Boolean);
+}
+export function isSkillAuthorOnlyPath(relativePath) {
+    const [topLevel] = pathSegments(relativePath);
+    return topLevel !== undefined && SKILL_AUTHOR_ONLY_DIRECTORIES.has(topLevel);
+}
+export function isSkillCollectionAuthorOnlyPath(relativePath) {
+    const [, skillTopLevel] = pathSegments(relativePath);
+    return skillTopLevel !== undefined && SKILL_AUTHOR_ONLY_DIRECTORIES.has(skillTopLevel);
+}
+//# sourceMappingURL=skill-authoring.js.map

package/dist/skill-authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-authoring.js","sourceRoot":"","sources":["../src/skill-authoring.ts"],"names":[],"mappings":"AAAA,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpE,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,MAAM,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC9C,OAAO,QAAQ,KAAK,SAAS,IAAI,6BAA6B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,YAAoB;IAClE,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,aAAa,KAAK,SAAS,IAAI,6BAA6B,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACzF,CAAC"}

package/dist/skill-frontmatter-capabilities.d.ts

@@ -0,0 +1,36 @@
+export type SkillFrontmatterProfile = 'portable-agent-skills' | 'claude-2.1.88' | 'claude-current';
+export type SkillFrontmatterDiagnosticCode = 'unknown-field' | 'known-field-not-supported-by-target-version' | 'known-field-requires-related-field' | 'known-field-invalid-type-value' | 'portable-profile-platform-extension';
+type SkillFrontmatterFieldType = 'boolean' | 'boolean-or-string' | 'boolean-or-string-or-binary-number' | 'object' | 'string' | 'string-map' | 'string-or-integer' | 'string-or-string-array';
+interface SkillFrontmatterFieldCapability {
+    owner: 'agent-skills' | 'claude';
+    type: SkillFrontmatterFieldType;
+    typeByProfile?: Partial<Record<SkillFrontmatterProfile, SkillFrontmatterFieldType>>;
+    required?: boolean;
+    profiles: SkillFrontmatterProfile[];
+    acceptedValues?: string[];
+    acceptedValuesByProfile?: Partial<Record<SkillFrontmatterProfile, string[]>>;
+    acceptedValuesCaseInsensitive?: boolean;
+    acceptedValuesCaseInsensitiveByProfile?: Partial<Record<SkillFrontmatterProfile, boolean>>;
+    requires?: Record<string, unknown>;
+    introducedVersion?: string | null;
+    verifiedAtVersion?: string;
+}
+interface SkillFrontmatterCapabilityRegistry {
+    schemaVersion: 1;
+    verifiedOn: string;
+    requiredSemantics: string;
+    profiles: Record<SkillFrontmatterProfile, {
+        platform: 'claude' | 'portable';
+        targetVersion: string | null;
+        description: string;
+    }>;
+    fields: Record<string, SkillFrontmatterFieldCapability>;
+}
+export interface SkillFrontmatterCapabilityDiagnostic {
+    code: SkillFrontmatterDiagnosticCode;
+    field: string;
+    message: string;
+}
+export declare function getSkillFrontmatterCapabilityRegistry(): SkillFrontmatterCapabilityRegistry;
+export declare function validateSkillFrontmatterCapabilities(frontmatter: Record<string, unknown>, profile: SkillFrontmatterProfile): SkillFrontmatterCapabilityDiagnostic[];
+export {};

package/dist/skill-frontmatter-capabilities.js

@@ -0,0 +1,120 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const registryDocument = require('./skill-frontmatter-capabilities.json');
+const REGISTRY = registryDocument;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(nonEmptyString);
+}
+function matchesType(value, type) {
+    switch (type) {
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'boolean-or-string':
+            return typeof value === 'boolean' || nonEmptyString(value);
+        case 'boolean-or-string-or-binary-number':
+            return typeof value === 'boolean'
+                || nonEmptyString(value)
+                || value === 0
+                || value === 1;
+        case 'object':
+            return isRecord(value);
+        case 'string':
+            return nonEmptyString(value);
+        case 'string-map':
+            return isRecord(value) && Object.values(value).every((entry) => typeof entry === 'string');
+        case 'string-or-integer':
+            return nonEmptyString(value) || (typeof value === 'number' && Number.isInteger(value));
+        case 'string-or-string-array':
+            return nonEmptyString(value) || isStringArray(value);
+    }
+}
+function unsupportedFieldDiagnostic(field, capability, profile) {
+    if (profile === 'portable-agent-skills' && capability.owner !== 'agent-skills') {
+        return {
+            code: 'portable-profile-platform-extension',
+            field,
+            message: `field ${JSON.stringify(field)} is a Claude Code extension and is not portable Agent Skills frontmatter`,
+        };
+    }
+    const introduced = capability.introducedVersion
+        ? `; documented minimum is Claude Code ${capability.introducedVersion}`
+        : '';
+    return {
+        code: 'known-field-not-supported-by-target-version',
+        field,
+        message: `field ${JSON.stringify(field)} is known but is not supported by profile ${JSON.stringify(profile)}${introduced}`,
+    };
+}
+export function getSkillFrontmatterCapabilityRegistry() {
+    return REGISTRY;
+}
+export function validateSkillFrontmatterCapabilities(frontmatter, profile) {
+    const diagnostics = [];
+    for (const field of Object.keys(frontmatter)) {
+        const capability = REGISTRY.fields[field];
+        if (!capability) {
+            diagnostics.push({
+                code: 'unknown-field',
+                field,
+                message: `field ${JSON.stringify(field)} is not registered for any supported Skill frontmatter profile`,
+            });
+            continue;
+        }
+        if (!capability.profiles.includes(profile)) {
+            diagnostics.push(unsupportedFieldDiagnostic(field, capability, profile));
+            continue;
+        }
+        const expectedType = capability.typeByProfile?.[profile] ?? capability.type;
+        const value = frontmatter[field];
+        if (!matchesType(value, expectedType)) {
+            diagnostics.push({
+                code: 'known-field-invalid-type-value',
+                field,
+                message: `field ${JSON.stringify(field)} must have type ${JSON.stringify(expectedType)} in profile ${JSON.stringify(profile)}`,
+            });
+            continue;
+        }
+        const acceptedValues = capability.acceptedValuesByProfile?.[profile]
+            ?? capability.acceptedValues;
+        const acceptedValuesCaseInsensitive = capability.acceptedValuesCaseInsensitiveByProfile?.[profile]
+            ?? capability.acceptedValuesCaseInsensitive
+            ?? false;
+        if (typeof value === 'string' &&
+            acceptedValues &&
+            !acceptedValues.includes(acceptedValuesCaseInsensitive ? value.trim().toLowerCase() : value.trim())) {
+            diagnostics.push({
+                code: 'known-field-invalid-type-value',
+                field,
+                message: `field ${JSON.stringify(field)} must be one of ${acceptedValues.map((entry) => JSON.stringify(entry)).join(', ')}`,
+            });
+        }
+        for (const [requiredField, requiredValue] of Object.entries(capability.requires ?? {})) {
+            if (frontmatter[requiredField] !== requiredValue) {
+                diagnostics.push({
+                    code: 'known-field-requires-related-field',
+                    field,
+                    message: `field ${JSON.stringify(field)} requires ${JSON.stringify(requiredField)}=${JSON.stringify(requiredValue)}`,
+                });
+            }
+        }
+    }
+    for (const [field, capability] of Object.entries(REGISTRY.fields)) {
+        if (capability.required &&
+            capability.profiles.includes(profile) &&
+            frontmatter[field] === undefined) {
+            diagnostics.push({
+                code: 'known-field-invalid-type-value',
+                field,
+                message: `required field ${JSON.stringify(field)} is missing for profile ${JSON.stringify(profile)}`,
+            });
+        }
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=skill-frontmatter-capabilities.js.map

package/dist/skill-frontmatter-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-frontmatter-capabilities.js","sourceRoot":"","sources":["../src/skill-frontmatter-capabilities.ts"],"names":[],"mappings":"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"}

package/dist/skill-frontmatter-capabilities.json

@@ -0,0 +1,200 @@
+{
+    "schemaVersion": 1,
+    "verifiedOn": "2026-08-12",
+    "requiredSemantics": "required is an AW authoring/package policy, not a claim that every host parser rejects omission",
+    "sources": {
+        "agentSkills": "https://agentskills.io/specification",
+        "claudeCurrent": "https://code.claude.com/docs/en/skills",
+        "claudeMinimum": "Claude Code 2.1.88 source snapshot: src/utils/frontmatterParser.ts and src/skills/loadSkillsDir.ts"
+    },
+    "profiles": {
+        "portable-agent-skills": {
+            "platform": "portable",
+            "targetVersion": null,
+            "description": "Agent Skills portable frontmatter only."
+        },
+        "claude-2.1.88": {
+            "platform": "claude",
+            "targetVersion": "2.1.88",
+            "description": "Claude Code fields verified at the AW minimum supported version."
+        },
+        "claude-current": {
+            "platform": "claude",
+            "targetVersion": "current",
+            "description": "Fields documented by current Claude Code documentation on the verification date."
+        }
+    },
+    "fields": {
+        "name": {
+            "owner": "agent-skills",
+            "type": "string",
+            "required": true,
+            "profiles": ["portable-agent-skills", "claude-2.1.88", "claude-current"]
+        },
+        "description": {
+            "owner": "agent-skills",
+            "type": "string",
+            "required": true,
+            "profiles": ["portable-agent-skills", "claude-2.1.88", "claude-current"]
+        },
+        "license": {
+            "owner": "agent-skills",
+            "type": "string",
+            "profiles": ["portable-agent-skills", "claude-2.1.88", "claude-current"]
+        },
+        "compatibility": {
+            "owner": "agent-skills",
+            "type": "string",
+            "profiles": ["portable-agent-skills", "claude-2.1.88", "claude-current"]
+        },
+        "metadata": {
+            "owner": "agent-skills",
+            "type": "string-map",
+            "typeByProfile": {
+                "claude-current": "object"
+            },
+            "profiles": ["portable-agent-skills", "claude-2.1.88", "claude-current"]
+        },
+        "allowed-tools": {
+            "owner": "agent-skills",
+            "type": "string",
+            "typeByProfile": {
+                "claude-2.1.88": "string-or-string-array",
+                "claude-current": "string-or-string-array"
+            },
+            "profiles": ["portable-agent-skills", "claude-2.1.88", "claude-current"]
+        },
+        "when_to_use": {
+            "owner": "claude",
+            "type": "string",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "argument-hint": {
+            "owner": "claude",
+            "type": "string",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "arguments": {
+            "owner": "claude",
+            "type": "string-or-string-array",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "version": {
+            "owner": "claude",
+            "type": "string",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "disable-model-invocation": {
+            "owner": "claude",
+            "type": "boolean-or-string-or-binary-number",
+            "typeByProfile": {
+                "claude-2.1.88": "boolean-or-string"
+            },
+            "acceptedValuesByProfile": {
+                "claude-2.1.88": ["true", "false"],
+                "claude-current": ["true", "false", "yes", "no", "on", "off", "1", "0"]
+            },
+            "acceptedValuesCaseInsensitiveByProfile": {
+                "claude-current": true
+            },
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "user-invocable": {
+            "owner": "claude",
+            "type": "boolean-or-string-or-binary-number",
+            "typeByProfile": {
+                "claude-2.1.88": "boolean-or-string"
+            },
+            "acceptedValuesByProfile": {
+                "claude-2.1.88": ["true", "false"],
+                "claude-current": ["true", "false", "yes", "no", "on", "off", "1", "0"]
+            },
+            "acceptedValuesCaseInsensitiveByProfile": {
+                "claude-current": true
+            },
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "disallowed-tools": {
+            "owner": "claude",
+            "type": "string-or-string-array",
+            "introducedVersion": null,
+            "profiles": ["claude-current"]
+        },
+        "model": {
+            "owner": "claude",
+            "type": "string",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "effort": {
+            "owner": "claude",
+            "type": "string",
+            "typeByProfile": {
+                "claude-2.1.88": "string-or-integer"
+            },
+            "verifiedAtVersion": "2.1.88",
+            "acceptedValuesByProfile": {
+                "claude-2.1.88": ["low", "medium", "high", "max"],
+                "claude-current": ["low", "medium", "high", "xhigh", "max"]
+            },
+            "acceptedValuesCaseInsensitive": true,
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "context": {
+            "owner": "claude",
+            "type": "string",
+            "acceptedValuesByProfile": {
+                "claude-2.1.88": ["inline", "fork"],
+                "claude-current": ["fork"]
+            },
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "agent": {
+            "owner": "claude",
+            "type": "string",
+            "requires": {
+                "context": "fork"
+            },
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "background": {
+            "owner": "claude",
+            "type": "boolean-or-string-or-binary-number",
+            "acceptedValues": ["true", "false", "yes", "no", "on", "off", "1", "0"],
+            "acceptedValuesCaseInsensitive": true,
+            "requires": {
+                "context": "fork"
+            },
+            "introducedVersion": "2.1.218",
+            "profiles": ["claude-current"]
+        },
+        "hooks": {
+            "owner": "claude",
+            "type": "object",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "paths": {
+            "owner": "claude",
+            "type": "string-or-string-array",
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        },
+        "shell": {
+            "owner": "claude",
+            "type": "string",
+            "acceptedValues": ["bash", "powershell"],
+            "acceptedValuesCaseInsensitive": true,
+            "verifiedAtVersion": "2.1.88",
+            "profiles": ["claude-2.1.88", "claude-current"]
+        }
+    }
+}