/**
 * Package overview for the official skills registry.
 *
 * Prefer `./skill-list` then `./skill-get` for agent workflows.
 *
 * @example
 * import skillsOverview from 'kody:@kody/skills'
 * const overview = await skillsOverview()
 */
export default async function skillsOverview() {
	return {
		package: '@kody/skills',
		kody_id: 'skills',
		public_url: 'https://kody.codes/@kody/skills',
		intent:
			'A generic registry of reusable agent skills. Fresh forks start empty in packageStorage(); an optional per-account plain repo named `skills` is the git durable home. Agents discover, read, and edit skills via skill_* exports. Mutations accept dryRun.',
		durable_home: 'packageStorage (legacy) or plain-repo:skills',
		recommended_flow: [
			'import skillList from "kody:@kody/skills/skill-list"; await skillList()',
			'import skillGet from "kody:@kody/skills/skill-get"; await skillGet({ id })',
			'import skillSave from "kody:@kody/skills/skill-save"; await skillSave({ id, path, content, name?, description?, dryRun: true })',
			'Bulk edits: repo_get_git_remote({ name: "skills" }) → clone → edit → push (live-at-HEAD); repo.pushed auto-resyncs skills_index',
		],
		subscriptions: ['repo.pushed'],
		jobs_enabled_by_default: false,
		exports: [
			'./skill-list',
			'./skill-get',
			'./skill-save',
			'./skill-delete',
			'./skill-history',
			'./skill-revert',
			'./skill-search',
			'./legacy-dump',
			'./migrate-to-repo',
			'./on-repo-pushed',
		],
	}
}