@thiennc/flutter-skills 0.1.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Flutter Skills contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,81 @@
+# Flutter Skills
+
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-25-2ea44f)](skills/)
+[![Validation](https://github.com/thiennc-tesoglobal/flutter-skills/actions/workflows/validate-repository.yml/badge.svg)](https://github.com/thiennc-tesoglobal/flutter-skills/actions/workflows/validate-repository.yml)
+[![License](https://img.shields.io/badge/License-BSD--3--Clause-blue)](LICENSE)
+
+25 package-neutral Agent Skills for building, reviewing, testing, and releasing Flutter apps without forcing a state-management package or folder structure.
+
+> Bộ skill giúp AI coding agent đọc dự án Flutter, chọn đúng chuyên môn, triển khai và xác minh kết quả theo conventions sẵn có.
+
+## Install
+
+Choose skills interactively:
+
+```sh
+npx @thiennc/flutter-skills
+```
+
+Start with the end-to-end workflow for a complete app or feature:
+
+```sh
+npx @thiennc/flutter-skills \
+  --agent codex \
+  --skill flutter-app-workflow
+```
+
+Install one specialist when the task is focused:
+
+```sh
+npx @thiennc/flutter-skills \
+  --agent codex \
+  --skill flutter-ui-design
+```
+
+Project installation is the default. Add `--global` to use the selected skills across projects.
+
+The direct GitHub installer remains available: `npx skills add thiennc-tesoglobal/flutter-skills`.
+
+> In a regular terminal, the installer asks which skills and agents to use. Inside Codex, it may detect Codex and install non-interactively; pass `--skill` explicitly when you do not want all 25 skills.
+
+### Claude Code bundles
+
+```sh
+/plugin marketplace add thiennc-tesoglobal/flutter-skills
+/plugin install flutter-core-skills@flutter-skills
+```
+
+Available bundles: `all-flutter-skills`, `flutter-core-skills`, `flutter-ui-skills`, and `flutter-engineering-skills`.
+
+## Catalog
+
+| Area | Skills |
+|---|---|
+| Workflow | `flutter-app-workflow`, `flutter-build-release`, `flutter-ci-cd`, `flutter-device-testing` |
+| Dart | `dart-language`, `dart-concurrency` |
+| Architecture | `flutter-architecture`, `flutter-state-management` |
+| UI | `flutter-ui-design`, `flutter-visual-effects`, `flutter-ui-patterns`, `flutter-responsive-layout`, `flutter-animation`, `flutter-navigation` |
+| Data | `flutter-networking`, `flutter-persistence` |
+| Quality | `flutter-code-review`, `flutter-security`, `flutter-testing`, `flutter-performance`, `flutter-observability`, `flutter-accessibility`, `flutter-localization` |
+| Platform | `flutter-platform-integration`, `flutter-notifications` |
+
+## Use
+
+Codex and compatible agents first see skill names and descriptions, then load only the relevant `SKILL.md` and references.
+
+```text
+Use $flutter-app-workflow to build a polished offline-first todo app,
+preserve the existing architecture, add tests, and verify it on Android.
+```
+
+For a focused task, name the specialist directly or let the agent route from the request. Installing every skill does not load every skill into the task context.
+
+## Quality
+
+The catalog contains **25 skills**, **77 behavior-focused evaluation cases**, and **23 cross-catalog routing cases**. Validation checks metadata, references, bundles, tests, and clean installation discovery.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for validation and contribution instructions, and [docs/SOURCES.md](docs/SOURCES.md) for the source policy.
+
+## License
+
+BSD 3-Clause. Flutter and Dart are trademarks of Google LLC. This independent project is not affiliated with or endorsed by Google or the Flutter team.

package/bin/flutter-skills.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from "../lib/cli.mjs";
+
+process.exitCode = run(process.argv.slice(2));

package/lib/cli.mjs

@@ -0,0 +1,69 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const packageMetadata = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+);
+
+export const packageVersion = packageMetadata.version;
+export const repository = "thiennc-tesoglobal/flutter-skills";
+export const skillsSource = `https://github.com/${repository}#v${packageVersion}`;
+
+export function installerArguments(args) {
+  return ["add", skillsSource, ...args];
+}
+
+export function helpText() {
+  return `Flutter Skills ${packageVersion}
+
+Usage:
+  npx @thiennc/flutter-skills [options]
+
+Options:
+  -s, --skill <skills>   Install selected skills
+  -a, --agent <agents>   Install for selected agents
+  -g, --global           Install at user level
+  -l, --list             List available skills
+  -y, --yes              Skip confirmation prompts
+      --all              Install every skill for every agent
+  -h, --help             Show this help
+  -v, --version          Show the wrapper version
+
+All installation options are forwarded to skills@${packageMetadata.dependencies.skills}.
+Source: ${skillsSource}`;
+}
+
+export function resolveSkillsCli() {
+  const packagePath = require.resolve("skills/package.json");
+  return join(dirname(packagePath), "bin", "cli.mjs");
+}
+
+export function run(args, options = {}) {
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+
+  if (args.includes("--help") || args.includes("-h")) {
+    stdout.write(`${helpText()}\n`);
+    return 0;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    stdout.write(`${packageVersion}\n`);
+    return 0;
+  }
+
+  const spawn = options.spawn ?? spawnSync;
+  const cliPath = options.cliPath ?? resolveSkillsCli();
+  const nodePath = options.nodePath ?? process.execPath;
+  const result = spawn(nodePath, [cliPath, ...installerArguments(args)], {
+    stdio: "inherit",
+  });
+
+  if (result.error) {
+    stderr.write(`Unable to start the skills installer: ${result.error.message}\n`);
+    return 1;
+  }
+  return Number.isInteger(result.status) ? result.status : 1;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@thiennc/flutter-skills",
+  "version": "0.1.1",
+  "description": "Install the Flutter Skills collection with one command.",
+  "type": "module",
+  "bin": {
+    "flutter-skills": "bin/flutter-skills.mjs"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test tests/test_npm_cli.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=22.20.0"
+  },
+  "dependencies": {
+    "skills": "1.5.23"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thiennc-tesoglobal/flutter-skills.git"
+  },
+  "homepage": "https://github.com/thiennc-tesoglobal/flutter-skills#readme",
+  "bugs": {
+    "url": "https://github.com/thiennc-tesoglobal/flutter-skills/issues"
+  },
+  "keywords": [
+    "agent-skills",
+    "codex",
+    "dart",
+    "flutter"
+  ],
+  "license": "BSD-3-Clause"
+}