Skip to content
Merged
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
9 changes: 2 additions & 7 deletions .agents/agents/reidbaker-agent/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,5 @@
# Agent Skills

Skills in `.agents/skills` are managed by `npx skills`.
The skills located in `skills/` within this agent directory are locally maintained custom skills.

To fetch the skills defined in `skills-lock.json`, run:

```bash
npx skills experimental_install
```
Skills in `skills/` are locally managed.
For external agent skills used during development of `dart_skills_lint`, see [`tool/dart_skills_lint/.agents/skills/README.md`](../../../tool/dart_skills_lint/.agents/skills/README.md).
45 changes: 28 additions & 17 deletions tool/dart_skills_lint/.agents/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,27 +4,38 @@ This directory (`tool/dart_skills_lint/.agents/skills/`) contains skills and con

## Setup Instructions

To set up this directory for development, you must install the remote skills using `npx`. These include general Dart development practices, testing fundamentals, and productivity tools that agents rely on.
To set up this directory for development, you must install the remote skills using the Dart `skills` package (`dart install skills@^1.0.0`). These include general Dart development practices, testing fundamentals, and productivity tools that agents rely on.

Run the following commands from the `tool/dart_skills_lint/` directory to fetch the dependencies:

```sh
# Ensure the skills CLI is globally installed (version 1.0.0 or higher)
dart install skills@^1.0.0

# Core Dart Skills
npx skills install kevmoo/dash_skills/skills/dart-best-practices
npx skills install kevmoo/dash_skills/skills/dart-doc-validation
npx skills install kevmoo/dash_skills/skills/dart-long-lines
npx skills install kevmoo/dash_skills/skills/dart-matcher-best-practices
npx skills install kevmoo/dash_skills/skills/dart-package-maintenance

npx skills install dart-lang/skills/skills/dart-migrate-to-checks-package
npx skills install dart-lang/skills/skills/dart-build-cli-app
npx skills install dart-lang/skills/skills/dart-collect-coverage
npx skills install dart-lang/skills/skills/dart-add-unit-test
npx skills install dart-lang/skills/skills/dart-use-pattern-matching
skills add kevmoo/dash_skills \
--skill dart-best-practices \
--skill dart-doc-validation \
--skill dart-long-lines \
--skill dart-matcher-best-practices \
--skill dart-modern-features \
--skill dart-package-maintenance \
--skill dart-test-coverage \
--skill dart-test-fundamentals \
--agent generic

skills add dart-lang/skills \
--skill dart-migrate-to-checks-package \
--skill dart-build-cli-app \
--skill dart-collect-coverage \
--skill dart-add-unit-test \
--skill dart-use-pattern-matching \
--agent generic

# Productivity and Workflows
npx skills install mattpocock/skills/skills/productivity/grill-me
npx skills install obra/superpowers/skills/test-driven-development
skills add mattpocock/skills --skill grill-me --agent generic
skills add obra/superpowers --skill test-driven-development --agent generic
skills add anthropics/skills --skill skill-creator --agent generic
```

## Overview and Philosophy
Expand All @@ -36,9 +47,9 @@ npx skills install obra/superpowers/skills/test-driven-development

When adding new external skills to this directory, follow these guidelines:

1. Use `npx skills install` to pull them from upstream.
1. Use `skills add <repo> --skill <name> --agent generic` to pull them from upstream.
2. Add the generated skill folder name to `.gitignore` inside this directory (`.agents/skills/.gitignore`) to prevent checking third-party content into version control.
3. Commit the updated `skills-lock.json` file located in `tool/dart_skills_lint/` to track dependency versions across the team.
3. Commit the updated configuration file located at `.config/dart_skills/skills_config.json` to track dependency versions across the team.

## Running Evaluations (Evals)

Expand Down Expand Up @@ -78,7 +89,7 @@ We use the Anthropic static evaluation viewer to inspect the runs and grades:

1. Download and install the `skill-creator` tool (which contains the viewer scripts) into the ignored `.agents/skills/` directory:
```sh
npx skills add anthropics/skills --skill skill-creator --yes
skills add anthropics/skills --skill skill-creator --agent generic
```
2. Run the python review generator script pointing to the skill workspace:
```sh
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
---
name: dart-skills-lint-integration
description: >
How to integrate, update, and configure the dart_skills_lint validation tool
within a repository. Make sure to use this skill whenever the user asks to
update dart_skills_lint, configure skills validation tests, fix skills linter
dependency drifts, verify repository state before editing, optimize
lint rules execution, or draft pull request submission commands.
How to roll, update, and integrate the dart_skills_lint dependency into repositories
(such as flutter/flutter). Use this skill when tasked with bumping dart_skills_lint
pinned commit refs in pubspec.yaml, configuring downstream test harnesses,
managing package hashes, and generating submission pull requests. Do NOT use
this skill for day-to-day skill validation or fixing skill markdown errors
(use dart-skills-lint-validation instead).
metadata:
internal: true
---
Expand Down
Loading
Loading