Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,18 @@
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "dart-package-kit",
"source": {
"source": "local",
"path": "./plugins/dart-package-kit"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Coding"
}
]
}
7 changes: 6 additions & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,12 @@
{
"name": "design-kit",
"source": "./plugins/design-kit"
},
{
"name": "dart-package-kit",
"source": "./plugins/dart-package-kit",
"description": "Package-specific guidance for ACK validation, Noir terminal apps, Mix styling, and Remix Flutter components."
}
],
"description": "Private Concepta plugins for product and engineering workflows."
"description": "Product, engineering, design, and Dart package plugins from Concepta."
}
6 changes: 4 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Agent Plugins

This repository owns Concepta's Product, Engineering, and Design kits for Codex
This repository owns Concepta's Product, Engineering, Design, and Dart Package kits for Codex
and Claude Code. Maintain these kits directly; do not introduce upstream skill
tracking, import/merge workflows, or synchronization with another skills repository.

Expand All @@ -13,7 +13,9 @@ tracking, import/merge workflows, or synchronization with another skills reposit
breakdowns distinct from implementation plans; no automatic handoff is required.
- Design Kit owns interface design, critique, accessibility, UX copy, and study planning.
Product Kit owns research synthesis; Engineering Kit owns functional verification.
- Dart/Flutter is an external official plugin managed by the client. Keep its
- Dart Package Kit owns workflows for ACK, Noir, Mix, and Remix. Use the consuming
project's resolved package as the API reference. Link to package-maintained guides and skills.
- General Dart/Flutter is an external official plugin managed by the client. Keep its
skills and MCP configuration out of these kits; see docs/external-plugins.md.

## Author and maintain
Expand Down
10 changes: 7 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,15 @@ repository; there is no upstream import, tracking, or merge workflow.
| --- | --- | --- | --- |
| [Product Kit](plugins/product-kit/README.md) | Research, requirements, PRDs, and delivery breakdowns | 6 | 0.3.2 |
| [Engineering Kit](plugins/engineering-kit/README.md) | Technical decisions, implementation, reviews, PR/CI workflows, writing, and verification | 16 | 0.2.0 |
| [Dart Package Kit](plugins/dart-package-kit/README.md) | ACK schemas, Noir terminal apps, Mix styling, and Remix UI components | 4 | 0.1.0 |
| [Design Kit](plugins/design-kit/README.md) | Interface design, critique, accessibility, UX copy, and research planning | 10 | 0.1.1 |

Product Kit owns the shared requirements, questions, and decisions. Engineering
Kit turns settled scope into implementation work without creating a second
requirement baseline. Use the skill that matches the task; no automatic sequence
or handoff is required.

A [flattened source snapshot](agent-plugins.flattened.md) is available for review.
An [earlier snapshot of the Product, Engineering, and Design kits](agent-plugins.flattened.md) is available for historical review. The plugin directories above contain the current skills.
Binary assets are listed by hash; install plugins from their folders, not the snapshot.

## Install
Expand All @@ -30,6 +31,7 @@ codex plugin marketplace add https://github.com/btwld/agent-plugins.git
codex plugin add product-kit@conceptadev
codex plugin add engineering-kit@conceptadev
codex plugin add design-kit@conceptadev
codex plugin add dart-package-kit@conceptadev
```

### Claude Code
Expand All @@ -39,15 +41,16 @@ claude plugin marketplace add https://github.com/btwld/agent-plugins.git
claude plugin install product-kit@conceptadev
claude plugin install engineering-kit@conceptadev
claude plugin install design-kit@conceptadev
claude plugin install dart-package-kit@conceptadev
```

Start a new session afterward. In Codex, request the relevant skill. Claude
commands include `/product-kit:write-prd`, `/product-kit:write-wbs`, and
`/engineering-kit:writing-plans`. Use one active provider for each plugin namespace;
cloning or maintaining this repository does not replace installed plugins.

Dart/Flutter uses a separate official provider. See [Dart/Flutter setup](docs/external-plugins.md).
Neither kit duplicates its skills or MCP server.
For general Dart and Flutter tasks, install the official provider. Dart Package
Kit adds workflows for four specific packages alongside it. [Dart and Flutter setup](docs/external-plugins.md)

## Maintain

Expand Down Expand Up @@ -77,6 +80,7 @@ python3 -m unittest discover -s tests
claude plugin validate plugins/product-kit --strict
claude plugin validate plugins/engineering-kit --strict
claude plugin validate plugins/design-kit --strict
claude plugin validate plugins/dart-package-kit --strict
claude plugin validate . --strict
```

Expand Down
5 changes: 3 additions & 2 deletions docs/external-plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,9 @@
Use `dart-flutter@dart-flutter` from the official
[Flutter plugin repository](https://github.com/flutter/agent-plugins).
Follow its [setup guide](https://docs.flutter.dev/ai/get-started) for SDK and client
requirements. This provider is separate from the company-owned Product and
Engineering kits; its skills and Dart MCP server are not copied into this repo.
requirements. The official provider supplies the general skills and the Dart MCP
server. For ACK, Noir, Mix, or Remix, install the company package kit alongside
it. [Dart Package Kit](../plugins/dart-package-kit/README.md)

## Install

Expand Down
11 changes: 11 additions & 0 deletions plugins/dart-package-kit/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"name": "dart-package-kit",
"version": "0.1.0",
"description": "Package-specific guidance for ACK validation, Noir terminal apps, Mix styling, and Remix Flutter components.",
"author": {
"name": "Concepta"
},
"skills": "./skills/",
"license": "BSD-3-Clause",
"repository": "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/btwld/agent-plugins"
}
25 changes: 25 additions & 0 deletions plugins/dart-package-kit/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
{
"name": "dart-package-kit",
"version": "0.1.0",
"description": "Package-specific guidance for ACK validation, Noir terminal apps, Mix styling, and Remix Flutter components.",
"author": {
"name": "Concepta"
},
"skills": "./skills/",
"interface": {
"displayName": "Dart Package Kit",
"shortDescription": "ACK, Noir, Mix, and Remix",
"longDescription": "Package-specific guidance for ACK validation, Noir terminal apps, Mix styling, and Remix Flutter components.",
"developerName": "Concepta",
"category": "Coding",
"capabilities": [
"Read",
"Write"
],
"defaultPrompt": [
"Help me use ACK, Noir, Mix, or Remix with the version in my project."
]
},
"license": "BSD-3-Clause",
"repository": "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/btwld/agent-plugins"
}
28 changes: 28 additions & 0 deletions plugins/dart-package-kit/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
BSD 3-Clause License

Copyright (c) 2026, Leo Farias

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.
16 changes: 16 additions & 0 deletions plugins/dart-package-kit/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Dart Package Kit

Four skills for projects that use ACK, Noir, Mix, or Remix. Each starts with the version resolved by the consuming project. You can use this kit alongside the official Dart and Flutter plugin.

| Skill | When to use it | Example request |
| --- | --- | --- |
| [ack](skills/ack/SKILL.md) | Validate structured input with the Dart ACK schema library. | “Validate this API response with ACK and show how to report a missing field.” |
| [noir](skills/noir/SKILL.md) | Build or debug an interactive terminal UI using Dart Noir. | “Show the selected row in my Noir terminal list and handle keyboard navigation.” |
| [mix](skills/mix/SKILL.md) | Style Flutter widgets using Mix tokens, modifiers, and variants. | “Give this Mix-styled panel different padding at the compact breakpoint.” |
| [remix-flutter](skills/remix-flutter/SKILL.md) | Build a Flutter interface with Remix components and the project's theme or presets. | “Use our Remix buttons for this form and preserve the loading state.” |

## Install

After registering the marketplace, run `codex plugin add dart-package-kit@conceptadev` or `claude plugin install dart-package-kit@conceptadev`. Start a fresh session. In Codex, try `$ack`. In Claude Code, try `/dart-package-kit:remix-flutter`.

If you already load a package's own skill, choose one entry for that task to avoid competing instructions. For a general SDK or framework task, use the official Dart and Flutter plugin. Package references and credits are in [SOURCES.md](SOURCES.md).
10 changes: 10 additions & 0 deletions plugins/dart-package-kit/SOURCES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Dart Package Kit sources

The workflow instructions in this plugin are original and distributed under the [plugin license](LICENSE). The package teams maintain the detailed APIs, examples, and guides. The following revisions identify the documentation reviewed when this kit was written.

| Package | Sources reviewed |
| --- | --- |
| ACK | [ACK LLM guide](https://github.com/btwld/ack/blob/b8eb8ebc9887cccaf21b7fe97a08fadc2839d0ba/llms.txt) · [published versions](https://pub.dev/packages/ack/versions) |
| Noir | [Noir terminal skill and references](https://github.com/btwld/noir/tree/1924c3ac3625dcf2f01c1b83a28ac1adb61ee12a/skills/noir) · [published versions](https://pub.dev/packages/noir/versions) |
| Mix | [Mix skill and references](https://github.com/btwld/mix/tree/e5259d8e65a32f7b7f11d14e6d734fe76226f8e6/skills/mix) · [published versions](https://pub.dev/packages/mix/versions) |
| Remix | [Remix usage and design-system skills](https://github.com/btwld/remix/tree/a3642ff2030efd42c1ecda9c3848e61fc7770f48/skills) · [published versions](https://pub.dev/packages/remix/versions) |
50 changes: 50 additions & 0 deletions plugins/dart-package-kit/skills/ack/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
name: ack
description: >-
Use when a Dart or Flutter project uses package:ack and needs to validate
untrusted input, define a schema or bidirectional codec, generate an Ack
model, import or export JSON Schema, or migrate between Ack versions.
Also use when the user explicitly asks to adopt Ack for one of these tasks.
---

# Ack schema validation

Start at the caller. Identify the input the application receives, the Dart value it needs, and whether another consumer expects that value to encode back to a particular wire format.

## Match the project's version

Read the consuming package's `pubspec.yaml` and resolved `pubspec.lock`, including workspace overrides. For Git or path dependencies inspect the resolved checkout. For a hosted package use the API reference and source for that release. Ack's `llms.txt` indexes the guides **on its own revision**. For example, the 2.0 beta index links to code generation and null-handling rules that differ from 1.7. When adding Ack to a new project, check SDK compatibility and respect the project's stable or prerelease policy. [Published releases](https://pub.dev/packages/ack/versions) · [Ack 1.7.1 guide index](https://github.com/btwld/ack/blob/v1.7.1/llms.txt) · [Ack 2.0.0-beta.3 guide index](https://github.com/btwld/ack/blob/v2.0.0-beta.3/llms.txt)

## Implement the boundary

- **Validate external input.** Define required fields and constraints with the fluent builders. Use `safeParse` when invalid input is an expected outcome. Branch on `isOk` or `isFail` before reading the value or error. Preserve the field-level error information the caller needs.
- **Model missing values deliberately.** Decide separately whether a field may be omitted, may contain JSON null, or needs a default. PATCH handlers commonly distinguish “leave unchanged” from “clear this field.” Check how the resolved version represents those two cases before mapping to a nullable Dart field.
- **Encode values sent elsewhere.** If parsing changes the type or representation, choose a bidirectional codec with an explicit encoding rule. Test the wire value produced by encoding. A one-way parse transform can be sufficient when the value stays inside the application.
- **Generate models or integrate a provider when the task calls for it.** Follow the matching model-generation or adapter guide in the index. Check compatibility of companion packages and SDK constraints. For generated models, edit the source definition, run the project's generator, and validate untrusted inputs at the parse boundary. For JSON Schema interchange, confirm the consumer's dialect and check a representative schema through the actual consumer.

For example, this schema accepts an omitted delivery note, an explicit null, or a string. A quantity of zero fails at the boundary.

```dart
import 'package:ack/ack.dart';

final orderSchema = Ack.object({
'quantity': Ack.integer().min(1),
'note': Ack.string().optional().nullable(),
});

void main() {
final result = orderSchema.safeParse({'quantity': 0});
if (result.isFail) {
final error = result.getError();
if (error is SchemaNestedError) {
for (final field in error.errors) {
print(field.path);
}
} else {
print(error.path);
}
}
}
```

Exercise a valid payload and the smallest invalid payload that demonstrates the rule. For a PATCH endpoint, also test omitted and explicit-null fields through the handler. For a codec or generated model, parse and encode a known input and compare the resulting wire payload. Run the project's analyzer and focused tests, and report which boundary they exercised.
27 changes: 27 additions & 0 deletions plugins/dart-package-kit/skills/ack/evals/evals.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
{
"skill_name": "ack",
"evals": [
{
"id": 1,
"prompt": "Our checkout service already uses ack 1.7.1. Validate an incoming order with a positive integer quantity and a delivery note that may be missing, null, or a string. A bad order should produce a field-specific validation error without a 500.",
"expected_output": "A version-compatible Ack object schema, safe handling of a rejected payload, and checks of the supported field states.",
"files": [],
"expectations": [
"Uses the resolved 1.7.1 API and keeps the existing dependency.",
"Requires a positive integer quantity and handles each of the three note states.",
"Inspects the failure branch before reading the error and tests a rejected quantity."
]
},
{
"id": 2,
"prompt": "We've pinned ack and ack_generator to 2.0.0-beta.3. A PATCH model currently treats both omitted nickname and explicit null as 'leave unchanged'. Fix it and make the outgoing JSON preserve the difference.",
"expected_output": "A version-matched model change and handler and encoding tests covering omitted, null, and present values.",
"files": [],
"expectations": [
"Checks the prerelease guide and the generated model's source definition.",
"Preserves three separate states through parsing, applying the patch, and encoding.",
"Regenerates affected files when needed and reports the checks actually run."
]
}
]
}
10 changes: 10 additions & 0 deletions plugins/dart-package-kit/skills/ack/evals/trigger_queries.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
[
{"query": "Validate incoming orders using the Ack dependency already in pubspec, and show which field caused a 400.", "should_trigger": true},
{"query": "How do I make package:ack preserve missing versus explicit-null keys in a PATCH model?", "should_trigger": true},
{"query": "Our Ack codec reads timestamps but emits the wrong representation on save. Can you fix the round trip?", "should_trigger": true},
{"query": "Migrate our Ack schemas from 1.7 to 2.0 and check the generated model changes.", "should_trigger": true},
{"query": "Add null-safe fromJson and toJson methods to this Dart class using only dart:convert.", "should_trigger": false},
{"query": "Write a build_runner generator for annotated classes in a Dart package.", "should_trigger": false},
{"query": "Why isn't our broker receiving the consumer's ACK between reconnects?", "should_trigger": false},
{"query": "Review this TypeScript Zod schema for my checkout endpoint.", "should_trigger": false}
]
24 changes: 24 additions & 0 deletions plugins/dart-package-kit/skills/mix/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
name: mix
description: Use when a Flutter task asks to change package:mix styles, layout primitives, tokens, or variants, or diagnose how a Mix styler resolves on a widget. Remix component behavior and generic Flutter layout have separate workflows.
---

# Style Flutter widgets with Mix

Find the widget that renders the affected surface and the style it receives. Check the resolved `mix` version in `pubspec.lock`. For path or Git dependencies, follow the package location in `.dart_tool/package_config.json`. Use that source to check the actual constructor, styler methods and token types before editing.

Work at the point that owns the appearance. To change a single widget, compose the appropriate concrete styler and pass it to that widget. Return or assign the new style from each fluent call. To change a shared design value, trace the token to its enclosing `MixScope` and identify which other widgets inherit it. For a state-specific change, inspect which widget supplies the hover, focus or press state. Keep changes to Remix component behavior, selection or semantics in the component that owns them.

For example, this Mix 2.4 widget adds a uniform inset to its child. Reuse the application's spacing token when one exists.

```dart
import 'package:flutter/widgets.dart';
import 'package:mix/mix.dart';

Widget insetPanel(Widget child) =>
Box(style: BoxStyler().padding(.all(12)), child: child);
```

Exercise the changed property in the consuming app. A spacing test can measure the distance between a keyed child and its parent. For a hover or theme change, exercise both states and inspect the visible result. Run the targeted widget test and Flutter analyzer using the project's SDK.

For version-specific examples, start from the installed package and the upstream guide for the relevant API. The Mix repository publishes its own full skill, with focused guides to layouts, variants, tokens, generators and testing. [Upstream Mix skill](https://github.com/btwld/mix/tree/main/skills/mix) · [Documentation index for agents](https://raw.githubusercontent.com/btwld/mix/main/llms.txt) · [Published versions](https://pub.dev/packages/mix/versions)
Loading