@santi020k/eslint-config-basic 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @santi020k/eslint-config-basic
 
+## 1.6.0
+
+### Minor Changes
+
+- [#85](https://github.com/santi020k/eslint-config-basic/pull/85) [`664693e`](https://github.com/santi020k/eslint-config-basic/commit/664693ef8edeb51239bf4dc2c75148203bcf41a6) Thanks [@santi020k](https://github.com/santi020k)! - Add `basic-eslint generate-skill` CLI command and `generateAgentSkills()` API.
+
+  The new command scans a project for AI coding-assistant agent folders (`.agent`, `.agents`, `.claude`, `.cursor`, `.windsurf`, `.copilot`, `.aider`) and writes a tailored ESLint standards skill file into each one. The generated file describes the active configuration (TypeScript, frameworks, testing, tools, etc.) and instructs the agent to follow the project's lint conventions automatically.
+
+  A companion GitHub Actions workflow (`.github/workflows/agent-skills.yml`) is included so projects can auto-regenerate skill files whenever the ESLint config changes.
+
+  **Usage:**
+
+  ```bash
+  npx basic-eslint generate-skill          # write skill files (skip existing)
+  npx basic-eslint generate-skill --force  # overwrite all skill files
+  ```
+
+  **Programmatic API:**
+
+  ```ts
+  import { generateAgentSkills } from "@santi020k/eslint-config-basic";
+
+  const { written, skipped } = generateAgentSkills({
+    cwd: process.cwd(),
+    force: true,
+  });
+  ```
+
+### Patch Changes
+
+- [#85](https://github.com/santi020k/eslint-config-basic/pull/85) [`664693e`](https://github.com/santi020k/eslint-config-basic/commit/664693ef8edeb51239bf4dc2c75148203bcf41a6) Thanks [@santi020k](https://github.com/santi020k)! - Load optional integrations lazily so projects can import the base config without installing unrelated integration peers such as Storybook, GraphQL, Stencil, Cypress, or Testing Library.
+
+  Also include the generated agent-skill API entry in the basic package build output so published packages do not reference a missing `agent-skill-generator.js` file.
+
+- Updated dependencies [[`664693e`](https://github.com/santi020k/eslint-config-basic/commit/664693ef8edeb51239bf4dc2c75148203bcf41a6)]:
+  - @santi020k/eslint-config-optionals@1.6.0
+  - @santi020k/eslint-config-core@1.6.0
+  - @santi020k/eslint-config-typescript@1.6.0
+
+## 1.5.0
+
+### Minor Changes
+
+- [#82](https://github.com/santi020k/eslint-config-basic/pull/82) [`af844f6`](https://github.com/santi020k/eslint-config-basic/commit/af844f663f8403d679467e0dd2a7251e8f3d4bcd) Thanks [@santi020k](https://github.com/santi020k)! - - Add first-class Hono support with Worker runtime globals, package detection, and a playground for Cloudflare Workers-style projects.
+  - Lower the Node.js engine requirement to `>=22.18.0` in `package.json` and `.nvmrc`, and validate CI against Node.js 22.
+  - Update `README.md` with a landing pointer to the canonical docs site.
+
+### Patch Changes
+
+- Updated dependencies [[`af844f6`](https://github.com/santi020k/eslint-config-basic/commit/af844f663f8403d679467e0dd2a7251e8f3d4bcd)]:
+  - @santi020k/eslint-config-core@1.5.0
+  - @santi020k/eslint-config-optionals@1.5.0
+  - @santi020k/eslint-config-typescript@1.5.0
+
 ## 1.4.0
 
 ### Minor Changes

package/dist/agent-skill-generator.d.ts

@@ -0,0 +1,86 @@
+interface AgentTarget {
+    /** Human-readable label for logging */
+    label: string;
+    /** Folder that must exist in cwd to be considered "present" */
+    markerFolder: string;
+    /** Subdirectory inside the agent folder where the skill file is placed */
+    skillSubdir: string;
+    /** File name for the generated skill */
+    skillFile: string;
+    /** Format variant used when generating content */
+    format: 'frontmatter' | 'cursor' | 'plain';
+}
+/**
+ * Features extracted from the project's actual `eslint.config.js`.
+ * All arrays hold display-friendly labels (e.g. `'TypeScript'`, `'React'`).
+ */
+interface EslintConfigFeatures {
+    typescript: boolean;
+    frameworks: string[];
+    testing: string[];
+    tools: string[];
+    libraries: string[];
+    formats: string[];
+    extensions: string[];
+    /** The lint command found in the project's package.json scripts, or a sensible default */
+    lintCommand: string;
+    /** Path to the config file that was loaded, or null when falling back to detection */
+    configFile: string | null;
+    /** Whether features came from the real config file or from package.json detection */
+    source: 'config-file' | 'detection-fallback';
+}
+interface GenerateSkillResult {
+    written: string[];
+    skipped: string[];
+}
+interface GenerateSkillOptions {
+    /** Working directory — defaults to process.cwd() */
+    cwd?: string;
+    /**
+     * Overwrite files that already exist.
+     * @default false
+     */
+    force?: boolean;
+}
+/**
+ * All AI coding-assistant agent folders that are probed for.
+ * Add new entries here as new agents emerge — the generator picks them up
+ * automatically on the next run.
+ */
+declare const AGENT_TARGETS: AgentTarget[];
+/**
+ * Loads the user's `eslint.config.js` (or `.mjs` / `.cjs`) via dynamic
+ * `import()` and derives features from the resulting flat-config array.
+ *
+ * Returns `null` when no config file is found or it cannot be imported.
+ */
+declare const analyzeEslintConfig: (cwd: string) => Promise<EslintConfigFeatures | null>;
+/**
+ * Builds the skill document body from the project's {@link EslintConfigFeatures}.
+ * Three format variants are produced:
+ *
+ * - `frontmatter` — YAML front-matter + Markdown (`.agent`, `.agents`, `.windsurf`)
+ * - `cursor`      — Cursor MDC front-matter + Markdown
+ * - `plain`       — pure Markdown, no front-matter (Claude Code, Copilot, Aider)
+ */
+declare const generateSkillContent: (features: EslintConfigFeatures, format: AgentTarget["format"]) => string;
+/**
+ * Detects which AI agent folders exist in the project, reads the actual
+ * `eslint.config.js` to understand what is configured, and writes a tailored
+ * ESLint standards skill file into each found folder.
+ *
+ * Falls back to package.json auto-detection when the config file cannot be
+ * dynamically imported (e.g. when running outside a built environment).
+ *
+ * @example
+ * ```ts
+ * import { generateAgentSkills } from '@santi020k/eslint-config-basic'
+ *
+ * const result = await generateAgentSkills({ cwd: process.cwd() })
+ * console.log('Written to:', result.written)
+ * ```
+ */
+declare const generateAgentSkills: (opts?: GenerateSkillOptions) => Promise<GenerateSkillResult>;
+declare const handleGenerateSkill: (cwd?: string, force?: boolean) => Promise<void>;
+
+export { AGENT_TARGETS, type AgentTarget, type EslintConfigFeatures, type GenerateSkillOptions, type GenerateSkillResult, analyzeEslintConfig, generateAgentSkills, generateSkillContent, handleGenerateSkill };

package/dist/agent-skill-generator.js

@@ -0,0 +1,520 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { detectProjectOptions } from "./index.js";
+const AGENT_TARGETS = [
+  {
+    label: ".agent (generic skill format)",
+    markerFolder: ".agent",
+    skillSubdir: "skills",
+    skillFile: "eslint-standards.md",
+    format: "frontmatter"
+  },
+  {
+    label: ".agents (generic skill format)",
+    markerFolder: ".agents",
+    skillSubdir: "skills",
+    skillFile: "eslint-standards.md",
+    format: "frontmatter"
+  },
+  {
+    label: "Claude Code (.claude/commands)",
+    markerFolder: ".claude",
+    skillSubdir: "commands",
+    skillFile: "eslint.md",
+    format: "plain"
+  },
+  {
+    label: "Cursor (.cursor/rules)",
+    markerFolder: ".cursor",
+    skillSubdir: "rules",
+    skillFile: "eslint-standards.mdc",
+    format: "cursor"
+  },
+  {
+    label: "Windsurf (.windsurf/rules)",
+    markerFolder: ".windsurf",
+    skillSubdir: "rules",
+    skillFile: "eslint-standards.md",
+    format: "frontmatter"
+  },
+  {
+    label: "Copilot (.copilot)",
+    markerFolder: ".copilot",
+    skillSubdir: "instructions",
+    skillFile: "eslint-standards.md",
+    format: "plain"
+  },
+  {
+    label: "Aider (.aider)",
+    markerFolder: ".aider",
+    skillSubdir: ".",
+    skillFile: "eslint-standards.md",
+    format: "plain"
+  }
+];
+const FEATURE_MAP = [
+  // TypeScript
+  ["eslint-config-typescript/", "typescript", "TypeScript"],
+  ["@typescript-eslint", "typescript", "TypeScript"],
+  // Frameworks
+  ["eslint-config-react/", "frameworks", "React"],
+  ["eslint-config-next/", "frameworks", "Next.js"],
+  ["eslint-config-vue/", "frameworks", "Vue"],
+  ["eslint-config-svelte/", "frameworks", "Svelte"],
+  ["eslint-config-astro/", "frameworks", "Astro"],
+  ["eslint-config-angular/", "frameworks", "Angular"],
+  ["eslint-config-nest/", "frameworks", "NestJS"],
+  ["eslint-config-hono/", "frameworks", "Hono"],
+  ["eslint-config-expo/", "frameworks", "Expo"],
+  ["eslint-config-qwik/", "frameworks", "Qwik"],
+  ["eslint-config-remix/", "frameworks", "Remix"],
+  ["eslint-config-solid/", "frameworks", "SolidJS"],
+  // Testing
+  ["optionals/vitest", "testing", "Vitest"],
+  ["optionals/jest", "testing", "Jest"],
+  ["optionals/playwright", "testing", "Playwright"],
+  ["optionals/cypress", "testing", "Cypress"],
+  ["optionals/testing-library", "testing", "Testing Library"],
+  // Tools
+  ["eslint-config/prettier", "tools", "Prettier"],
+  ["optionals/cspell", "tools", "CSpell"],
+  ["eslint-config-optionals/jsdoc", "tools", "JSDoc"],
+  ["optionals/swagger", "tools", "Swagger"],
+  // Libraries
+  ["santi020k/tailwind/", "libraries", "Tailwind CSS"],
+  ["optionals/i18next", "libraries", "i18next"],
+  ["optionals/stencil", "libraries", "Stencil"],
+  ["optionals/storybook", "libraries", "Storybook"],
+  ["eslint-config-optionals/tanstack-query", "libraries", "TanStack Query"],
+  ["eslint-config-optionals/tanstack-router", "libraries", "TanStack Router"],
+  // Formats
+  ["optionals/graphql/", "formats", "GraphQL"],
+  ["optionals/yaml/", "formats", "YAML"],
+  ["optionals/jsonc/", "formats", "JSONC"],
+  ["optionals/markdown", "formats", "Markdown"],
+  ["eslint-config-mdx/", "formats", "MDX"],
+  ["optionals/toml/", "formats", "TOML"],
+  // Extensions
+  ["eslint-config/unicorn", "extensions", "Unicorn"],
+  ["eslint-config/sonarjs", "extensions", "SonarJS"],
+  ["eslint-config-optionals/security", "extensions", "Security"],
+  ["eslint-config-optionals/perfectionist", "extensions", "Perfectionist"],
+  ["optionals/regexp", "extensions", "Regexp"],
+  ["eslint-config/best-practices", "extensions", "Best Practices"]
+];
+const DETECTED_FRAMEWORK_LABELS = {
+  angular: "Angular",
+  astro: "Astro",
+  expo: "Expo",
+  hono: "Hono",
+  nest: "NestJS",
+  next: "Next.js",
+  qwik: "Qwik",
+  react: "React",
+  remix: "Remix",
+  solid: "SolidJS",
+  svelte: "Svelte",
+  vue: "Vue"
+};
+const FEATURE_LABELS = {
+  "best-practices": "Best Practices",
+  cspell: "CSpell",
+  cypress: "Cypress",
+  graphql: "GraphQL",
+  i18next: "i18next",
+  jest: "Jest",
+  jsdoc: "JSDoc",
+  jsonc: "JSONC",
+  markdown: "Markdown",
+  mdx: "MDX",
+  perfectionist: "Perfectionist",
+  playwright: "Playwright",
+  prettier: "Prettier",
+  regexp: "Regexp",
+  security: "Security",
+  sonarjs: "SonarJS",
+  stencil: "Stencil",
+  storybook: "Storybook",
+  swagger: "Swagger",
+  tailwind: "Tailwind CSS",
+  "tanstack-query": "TanStack Query",
+  "tanstack-router": "TanStack Router",
+  "testing-library": "Testing Library",
+  toml: "TOML",
+  unicorn: "Unicorn",
+  vitest: "Vitest",
+  yaml: "YAML"
+};
+const toFeatureLabel = (value) => FEATURE_LABELS[value] ?? value;
+const collectTokens = (configs) => {
+  const tokens = [];
+  for (const entry of configs) {
+    if (!entry || typeof entry !== "object") continue;
+    const cfg = entry;
+    if (typeof cfg.name === "string") {
+      tokens.push(cfg.name);
+    }
+    if (cfg.plugins && typeof cfg.plugins === "object") {
+      tokens.push(...Object.keys(cfg.plugins));
+    }
+    if (cfg.rules && typeof cfg.rules === "object") {
+      for (const key of Object.keys(cfg.rules)) {
+        const slash = key.indexOf("/");
+        if (slash > -1) tokens.push(key.slice(0, slash));
+      }
+    }
+  }
+  return tokens;
+};
+const extractFeatures = (configs, lintCommand, configFile) => {
+  const tokens = collectTokens(configs);
+  const features = {
+    typescript: false,
+    frameworks: [],
+    testing: [],
+    tools: [],
+    libraries: [],
+    formats: [],
+    extensions: [],
+    lintCommand,
+    configFile,
+    source: "config-file"
+  };
+  const seen = /* @__PURE__ */ new Set();
+  for (const [pattern, category, label] of FEATURE_MAP) {
+    if (seen.has(label)) continue;
+    const matched = tokens.some((t) => t.includes(pattern));
+    if (!matched) continue;
+    seen.add(label);
+    if (category === "typescript") {
+      features.typescript = true;
+    } else {
+      features[category].push(label);
+    }
+  }
+  return features;
+};
+const findEslintConfig = (cwd) => {
+  for (const name of ["eslint.config.js", "eslint.config.mjs", "eslint.config.cjs"]) {
+    const p = join(cwd, name);
+    if (existsSync(p)) return p;
+  }
+  return null;
+};
+const detectLintCommand = (cwd) => {
+  let pkgManager = "npm";
+  if (existsSync(join(cwd, "pnpm-lock.yaml")) || existsSync(join(cwd, "pnpm-workspace.yaml"))) {
+    pkgManager = "pnpm";
+  } else if (existsSync(join(cwd, "yarn.lock"))) {
+    pkgManager = "yarn";
+  } else if (existsSync(join(cwd, "bun.lockb")) || existsSync(join(cwd, "bun.lock"))) {
+    pkgManager = "bun";
+  }
+  const pkgPath = join(cwd, "package.json");
+  try {
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      if (pkg.scripts?.lint) return `${pkgManager} run lint`;
+    }
+  } catch {
+  }
+  return "npx eslint .";
+};
+const analyzeEslintConfig = async (cwd) => {
+  const configPath = findEslintConfig(cwd);
+  if (!configPath) return null;
+  const lintCommand = detectLintCommand(cwd);
+  try {
+    const mod = await import(pathToFileURL(resolve(configPath)).href);
+    const raw = mod.default ?? mod;
+    let configs = null;
+    if (Array.isArray(raw)) {
+      configs = raw;
+    } else if (raw instanceof Promise) {
+      configs = await raw;
+    }
+    if (!Array.isArray(configs)) return null;
+    return extractFeatures(configs, lintCommand, configPath);
+  } catch {
+    return null;
+  }
+};
+const featuresFromDetection = (cwd) => {
+  const opts = detectProjectOptions(cwd);
+  const lintCommand = detectLintCommand(cwd);
+  const frameworks = (opts.detectedFrameworks ?? []).map((f) => DETECTED_FRAMEWORK_LABELS[f] ?? f);
+  return {
+    typescript: opts.typescript === true,
+    frameworks,
+    testing: (opts.testing ?? []).map(toFeatureLabel),
+    tools: (opts.tools ?? []).map(toFeatureLabel),
+    libraries: (opts.libraries ?? []).map(toFeatureLabel),
+    formats: (opts.formats ?? []).map(toFeatureLabel),
+    extensions: (opts.extensions ?? []).map(toFeatureLabel),
+    lintCommand,
+    configFile: null,
+    source: "detection-fallback"
+  };
+};
+const generateSkillContent = (features, format) => {
+  const { typescript, frameworks, testing, tools, libraries, formats, extensions, lintCommand } = features;
+  const summaryLines = [];
+  summaryLines.push(`- **TypeScript**: ${typescript ? "enabled" : "disabled"}`);
+  if (frameworks.length > 0) summaryLines.push(`- **Frameworks**: ${frameworks.join(", ")}`);
+  if (testing.length > 0) summaryLines.push(`- **Testing**: ${testing.join(", ")}`);
+  if (tools.length > 0) summaryLines.push(`- **Tools**: ${tools.join(", ")}`);
+  if (libraries.length > 0) summaryLines.push(`- **Libraries**: ${libraries.join(", ")}`);
+  if (formats.length > 0) summaryLines.push(`- **Formats**: ${formats.join(", ")}`);
+  if (extensions.length > 0) summaryLines.push(`- **Extensions**: ${extensions.join(", ")}`);
+  const tsSection = typescript ? `
+### TypeScript
+
+- Use explicit type annotations on all exported functions and values
+- Use \`import type\` for type-only imports
+- Avoid \`any\` \u2014 prefer \`unknown\` with type guards
+- Prefer \`const\` over \`let\` whenever the binding is not reassigned
+- Return types must be explicit on exported functions
+` : "";
+  const frameworkSections = [];
+  if (frameworks.some((f) => f === "React" || f === "Next.js")) {
+    frameworkSections.push(`
+### React / JSX
+
+- Prefer function components over class components
+- Hooks must follow the Rules of Hooks (no conditional calls, no loops)
+- Avoid inline arrow functions in JSX props where it hurts readability
+- Use \`key\` props when rendering lists
+`);
+  }
+  if (frameworks.includes("Next.js")) {
+    frameworkSections.push(`
+### Next.js
+
+- Follow App Router conventions (Server Components by default, \`"use client"\` when needed)
+- Avoid \`<img>\` \u2014 use \`next/image\`
+- Avoid \`<a>\` for internal navigation \u2014 use \`next/link\`
+`);
+  }
+  if (frameworks.includes("Vue")) {
+    frameworkSections.push(`
+### Vue
+
+- Prefer Composition API (\`<script setup>\`) over Options API
+- Use single-word or multi-word component names consistently
+`);
+  }
+  if (frameworks.includes("Svelte")) {
+    frameworkSections.push(`
+### Svelte
+
+- Virtual \`*.svelte/*.ts\` files are handled by the ESLint config \u2014 do not manually adjust \`allowDefaultProject\`
+`);
+  }
+  if (frameworks.includes("Astro")) {
+    frameworkSections.push(`
+### Astro
+
+- Virtual \`*.astro/*.ts\` files are handled by the ESLint config
+- Prefer Astro components over framework components when no interactivity is needed
+`);
+  }
+  if (frameworks.includes("Angular")) {
+    frameworkSections.push(`
+### Angular
+
+- Follow the Angular style guide component, directive, and service naming conventions
+- Use standalone components by default; avoid NgModule unless required
+`);
+  }
+  const testingSections = [];
+  if (testing.some((t) => t === "Vitest" || t === "Jest")) {
+    testingSections.push(`
+### Tests
+
+- Name test files \`*.test.ts\` or \`*.spec.ts\`
+- Use \`describe\` blocks to group related cases
+- Avoid testing implementation details \u2014 test observable behaviour
+`);
+  }
+  if (testing.includes("Playwright")) {
+    testingSections.push(`
+### Playwright
+
+- Place tests in a dedicated \`e2e/\` or \`tests/\` directory
+- Use \`page.getByRole\` / \`page.getByText\` over CSS selectors where possible
+`);
+  }
+  const toolSections = [];
+  if (tools.includes("Prettier")) {
+    toolSections.push(`
+### Formatting
+
+- Do not manually format \u2014 Prettier handles all formatting
+- Prettier runs as the **last** ESLint config; never override its rules
+`);
+  }
+  if (tools.includes("Tailwind CSS") || libraries.includes("Tailwind CSS")) {
+    toolSections.push(`
+### Tailwind CSS
+
+- Use Tailwind utility classes directly in templates rather than hand-written CSS where possible
+- The \`better-tailwindcss\` plugin enforces ordering; do not disable class-ordering rules
+`);
+  }
+  const body = `# ESLint Code Standards
+
+This project uses [\`@santi020k/eslint-config-basic\`](https://github.com/santi020k/eslint-config-basic) \u2014 a composable ESLint 9/10+ Flat Config package.
+
+**Always run \`${lintCommand}\` to validate your changes before finishing any task.**
+
+## Active Configuration
+
+${summaryLines.join("\n")}
+
+## Conventions
+${tsSection}${frameworkSections.join("")}${testingSections.join("")}${toolSections.join("")}
+### General
+
+- ESLint 9/10 **Flat Config** format only \u2014 no \`.eslintrc\` files
+- Use \`.js\` extensions on relative imports (ESM requirement)
+- Use \`type\` imports for type-only values; regular imports for runtime values
+
+## Verification
+
+\`\`\`bash
+${lintCommand}
+\`\`\`
+
+If the command is unavailable, fall back to:
+
+\`\`\`bash
+npx eslint .
+\`\`\`
+`;
+  if (format === "frontmatter") {
+    return `---
+name: eslint-standards
+description: >
+  Code quality standards enforced by @santi020k/eslint-config-basic. Follow these
+  conventions whenever writing or editing code in this project.
+trigger: always_on
+---
+
+${body}`;
+  }
+  if (format === "cursor") {
+    return `---
+description: >
+  ESLint code standards for this project. Apply these conventions when writing
+  or editing any source file.
+globs:
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "**/*.js"
+  - "**/*.jsx"
+  - "**/*.vue"
+  - "**/*.svelte"
+  - "**/*.astro"
+alwaysApply: true
+---
+
+${body}`;
+  }
+  return body;
+};
+const writeSkillFile = (filePath, content, force) => {
+  if (existsSync(filePath) && !force) return false;
+  mkdirSync(join(filePath, ".."), { recursive: true });
+  writeFileSync(filePath, content, "utf-8");
+  return true;
+};
+const COPILOT_INSTRUCTIONS_PATH = ".github/copilot-instructions.md";
+const COPILOT_SECTION_START = "<!-- eslint-standards:start -->";
+const COPILOT_SECTION_END = "<!-- eslint-standards:end -->";
+const handleCopilotInstructions = (cwd, body, force) => {
+  const filePath = join(cwd, COPILOT_INSTRUCTIONS_PATH);
+  if (!existsSync(filePath)) return null;
+  const existing = readFileSync(filePath, "utf-8");
+  if (existing.includes(COPILOT_SECTION_START)) {
+    if (!force) return "skipped";
+    const updated = existing.replace(
+      new RegExp(`${COPILOT_SECTION_START}[\\s\\S]*?${COPILOT_SECTION_END}`, "g"),
+      `${COPILOT_SECTION_START}
+${body}
+${COPILOT_SECTION_END}`
+    );
+    writeFileSync(filePath, updated, "utf-8");
+    return "written";
+  }
+  writeFileSync(
+    filePath,
+    `${existing}
+${COPILOT_SECTION_START}
+${body}
+${COPILOT_SECTION_END}
+`,
+    "utf-8"
+  );
+  return "written";
+};
+const generateAgentSkills = async (opts = {}) => {
+  const cwd = opts.cwd ?? process.cwd();
+  const force = opts.force ?? false;
+  const written = [];
+  const skipped = [];
+  const features = await analyzeEslintConfig(cwd) ?? featuresFromDetection(cwd);
+  const plainBody = generateSkillContent(features, "plain");
+  const copilotResult = handleCopilotInstructions(cwd, plainBody, force);
+  if (copilotResult === "written") written.push(join(cwd, COPILOT_INSTRUCTIONS_PATH));
+  else if (copilotResult === "skipped") skipped.push(join(cwd, COPILOT_INSTRUCTIONS_PATH));
+  for (const target of AGENT_TARGETS) {
+    const agentFolder = join(cwd, target.markerFolder);
+    if (!existsSync(agentFolder)) continue;
+    const subdir = target.skillSubdir === "." ? agentFolder : join(agentFolder, target.skillSubdir);
+    const filePath = join(subdir, target.skillFile);
+    const content = generateSkillContent(features, target.format);
+    const didWrite = writeSkillFile(filePath, content, force);
+    if (didWrite) written.push(filePath);
+    else skipped.push(filePath);
+  }
+  return { written, skipped };
+};
+const handleGenerateSkill = async (cwd = process.cwd(), force = false) => {
+  console.log("\u{1F50D} Scanning for AI agent folders...");
+  const configFile = findEslintConfig(cwd);
+  if (configFile) {
+    console.log(`\u{1F4C4} Reading config from: ${configFile.replace(cwd + "/", "")}`);
+  } else {
+    console.log("\u26A0\uFE0F  No eslint.config.js found \u2014 falling back to package.json detection.");
+  }
+  const result = await generateAgentSkills({ cwd, force });
+  if (result.written.length === 0 && result.skipped.length === 0) {
+    console.log(
+      "\n\u26A0\uFE0F  No agent folders found (.agent, .agents, .claude, .cursor, .windsurf, .copilot, .aider)."
+    );
+    console.log("   Create one of those folders first, then re-run this command.");
+    return;
+  }
+  for (const file of result.written) {
+    console.log(`\u2705 Written: ${file.replace(cwd + "/", "")}`);
+  }
+  for (const file of result.skipped) {
+    console.log(`\u23ED\uFE0F  Skipped (already exists): ${file.replace(cwd + "/", "")}`);
+  }
+  if (result.written.length > 0) {
+    console.log(`
+\u{1F389} Generated ${result.written.length} skill file(s)!`);
+    console.log("   Agents will now follow your project's ESLint standards automatically.");
+  }
+  if (result.skipped.length > 0) {
+    console.log("\n\u{1F4A1} Tip: run with --force to overwrite existing skill files.");
+  }
+};
+export {
+  AGENT_TARGETS,
+  analyzeEslintConfig,
+  generateAgentSkills,
+  generateSkillContent,
+  handleGenerateSkill
+};

package/dist/cli.js

@@ -2,6 +2,7 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { handleGenerateSkill } from "./agent-skill-generator.js";
 import { detectProjectOptions } from "./index.js";
 const getDefaultConfigFilename = (cwd) => {
   const packageJsonPath = join(cwd, "package.json");
@@ -76,12 +77,18 @@ const handleUpdate = (cwd = process.cwd()) => {
 };
 const run = () => {
   const command = process.argv[2];
+  const hasForce = process.argv.includes("--force");
   if (command === "init") {
     handleInit();
   } else if (command === "update") {
     handleUpdate();
+  } else if (command === "generate-skill") {
+    handleGenerateSkill(process.cwd(), hasForce).catch((err) => {
+      console.error("\u274C Failed to generate skill files:", err);
+      process.exitCode = 1;
+    });
   } else {
-    console.log("Usage: basic-eslint <init|update>");
+    console.log("Usage: basic-eslint <init|update|generate-skill> [--force]");
   }
 };
 if (process.argv[1] && (process.argv[1] === fileURLToPath(import.meta.url) || process.argv[1].endsWith("cli.js") || process.argv[1].endsWith("cli.ts"))) {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { EslintConfigOptions, FlatConfigArray } from '@santi020k/eslint-config-core';
 export { DetectedFrameworkName, EslintConfigOptions, Extension, FlatConfigArray, Format, ImportedFramework, Library, NextMode, Preset, ReactConfigKeys, Runtime, Setting, Testing, Tool, coreConfig, createCoreConfig, detectProjectOptions, getGlobalsForRuntime, gitignore, hasReactConfig, jsConfig } from '@santi020k/eslint-config-core';
+export { AGENT_TARGETS, AgentTarget, GenerateSkillOptions, GenerateSkillResult, generateAgentSkills, generateSkillContent } from './agent-skill-generator.js';
 export { tsConfig, typescriptConfig } from '@santi020k/eslint-config-typescript';
 export { bestPractices, cspell, cypress, graphql, i18next, jest, jsdoc, jsonc, markdown, mdx, perfectionist, playwright, prettier, regexp, security, sonarjs, stencil, storybook, swagger, tailwind, tanstackQuery, tanstackRouter, testingLibrary, toml, unicorn, vitest, yaml } from '@santi020k/eslint-config-optionals';
 

package/dist/index.js

@@ -11,6 +11,11 @@ import {
   Setting
 } from "@santi020k/eslint-config-core";
 import { createTypescriptConfig } from "@santi020k/eslint-config-typescript";
+import {
+  AGENT_TARGETS,
+  generateAgentSkills,
+  generateSkillContent
+} from "./agent-skill-generator.js";
 import {
   coreConfig as coreConfig2,
   createCoreConfig as createCoreConfig2,
@@ -104,6 +109,7 @@ const eslintConfig = (options) => {
   });
   const expoParam = resolveFramework("expo", frameworks.expo);
   const nestParam = resolveFramework("nest", frameworks.nest);
+  const honoParam = resolveFramework("hono", frameworks.hono, { runtime });
   const vueParam = resolveFramework("vue", frameworks.vue);
   const svelteParam = resolveFramework("svelte", frameworks.svelte);
   const solidParam = resolveFramework("solid", frameworks.solid);
@@ -130,6 +136,7 @@ const eslintConfig = (options) => {
     ...nextParam,
     ...expoParam,
     ...nestParam,
+    ...honoParam,
     ...vueParam,
     ...svelteParam,
     ...solidParam,
@@ -164,6 +171,7 @@ const eslintConfig = (options) => {
   return applyStrictMode(configs, strict);
 };
 export {
+  AGENT_TARGETS,
   Extension,
   Format,
   Library,
@@ -181,6 +189,8 @@ export {
   cypress,
   detectProjectOptions2 as detectProjectOptions,
   eslintConfig,
+  generateAgentSkills,
+  generateSkillContent,
   getGlobalsForRuntime,
   gitignore2 as gitignore,
   graphql,

package/dist/resolvers.js

@@ -39,6 +39,11 @@ const resolvePreset = (preset) => {
         typescript: true,
         runtime: Runtime.Browser
       };
+    case Preset.Worker:
+      return {
+        typescript: true,
+        runtime: Runtime.Worker
+      };
     case Preset.All:
       return {
         typescript: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@santi020k/eslint-config-basic",
-  "version": "1.4.0",
-  "description": "A composable ESLint 9/10+ Flat Config package for JavaScript, TypeScript, React, Next.js, Vue, Svelte, Solid, Angular, Astro, Expo, NestJS, Qwik, and Remix.",
+  "version": "1.6.0",
+  "description": "A composable ESLint 9/10+ Flat Config package for JavaScript, TypeScript, React, Next.js, Vue, Svelte, Solid, Angular, Astro, Expo, NestJS, Hono, Qwik, and Remix.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -23,22 +23,23 @@
   "dependencies": {
     "@typescript-eslint/utils": "^8.59.0",
     "eslint": "^10.2.1",
-    "@santi020k/eslint-config-core": "^1.4.0",
-    "@santi020k/eslint-config-optionals": "^1.4.0",
-    "@santi020k/eslint-config-typescript": "^1.4.0"
+    "@santi020k/eslint-config-core": "^1.6.0",
+    "@santi020k/eslint-config-optionals": "^1.6.0",
+    "@santi020k/eslint-config-typescript": "^1.6.0"
   },
   "peerDependencies": {
-    "@santi020k/eslint-config-angular": "^1.4.0",
-    "@santi020k/eslint-config-astro": "^1.4.0",
-    "@santi020k/eslint-config-expo": "^1.4.0",
-    "@santi020k/eslint-config-nest": "^1.4.0",
-    "@santi020k/eslint-config-next": "^1.4.0",
-    "@santi020k/eslint-config-qwik": "^1.4.0",
-    "@santi020k/eslint-config-react": "^1.4.0",
-    "@santi020k/eslint-config-remix": "^1.4.0",
-    "@santi020k/eslint-config-solid": "^1.4.0",
-    "@santi020k/eslint-config-svelte": "^1.4.0",
-    "@santi020k/eslint-config-vue": "^1.4.0"
+    "@santi020k/eslint-config-angular": "^1.6.0",
+    "@santi020k/eslint-config-astro": "^1.6.0",
+    "@santi020k/eslint-config-expo": "^1.6.0",
+    "@santi020k/eslint-config-hono": "^1.6.0",
+    "@santi020k/eslint-config-nest": "^1.6.0",
+    "@santi020k/eslint-config-next": "^1.6.0",
+    "@santi020k/eslint-config-qwik": "^1.6.0",
+    "@santi020k/eslint-config-react": "^1.6.0",
+    "@santi020k/eslint-config-remix": "^1.6.0",
+    "@santi020k/eslint-config-solid": "^1.6.0",
+    "@santi020k/eslint-config-svelte": "^1.6.0",
+    "@santi020k/eslint-config-vue": "^1.6.0"
   },
   "peerDependenciesMeta": {
     "@santi020k/eslint-config-angular": {
@@ -50,6 +51,9 @@
     "@santi020k/eslint-config-expo": {
       "optional": true
     },
+    "@santi020k/eslint-config-hono": {
+      "optional": true
+    },
     "@santi020k/eslint-config-nest": {
       "optional": true
     },
@@ -84,7 +88,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=22.18.0"
   },
   "license": "MIT",
   "author": "santi020k",

package/dist/cli.d.ts

@@ -1,4 +0,0 @@
-declare const handleInit: (cwd?: string) => void;
-declare const handleUpdate: (cwd?: string) => void;
-
-export { handleInit, handleUpdate };