@kentcdodds/skills

/**
 * Package overview for the skills registry.
 *
 * Prefer `./skill-list` then `./skill-get` for agent workflows.
 *
 * @example
 * import skillsOverview from 'kody:@kentcdodds/skills'
 * const overview = await skillsOverview()
 */
export default async function skillsOverview() {
	return {
		package: '@kentcdodds/skills',
		kodyId: 'skills',
		intent:
			"A generic registry of reusable agent skills whose durable home is this package's packageStorage (SQLite). A leftover plain repo named skills is optional and is not required for skillGet. Agents discover, read, and edit skills via skill-* exports.",
		durableHome: 'package-storage',
		recommendedFlow: [
			'import skillList from "kody:@kentcdodds/skills/skill-list"; await skillList({})',
			'import skillGet from "kody:@kentcdodds/skills/skill-get"; await skillGet({ id })',
			'import skillSave from "kody:@kentcdodds/skills/skill-save"; await skillSave({ id, path, content, name?, description? })',
			'or packages.invoke({ kodyId: "skills", exportName: "./skill-get", params: { id } }) for current-version resolution from another package',
			'Bulk edits: skillSave / skillDelete (package storage). Optional leftover plain repo is not required.',
		],
		subscriptions: ['repo.pushed'],
		exports: [
			'./skill-list',
			'./skill-get',
			'./skill-save',
			'./skill-delete',
			'./skill-history',
			'./skill-revert',
			'./skill-search',
			'./legacy-dump',
			'./migrate-to-repo',
			'./on-repo-pushed',
			'./use-package-storage',
		],
	}
}