Workflow - AI coding skills

A collection of reusable skills and assistant instructions that extend LLM capabilities with specialized knowledge and workflows.

What's inside

Skills

Reusable skills that provide specialized knowledge and capabilities:

Skill	Description
code-review	Review code changes and report issues
cost-aware-development	Assess the cost impact of development decisions
commit-creator	Create conventional commits and commit messages
drizzle-orm	Write and review database queries with Drizzle ORM
github-release	Create GitHub releases and release notes
implementation-workflow	Plan, implement, and verify repository changes
instructions-master	Write and improve skills and assistant instructions
markdownlint	Set up and troubleshoot Markdown linting
playwright-e2e-testing	Write and maintain browser and API tests with Playwright
pr-creator	Create and update GitHub pull requests
repository-updater	Review and apply dependency and tooling updates
test-audit	Assess test quality and usefulness
typescript-conventions	Use consistent conventions for TypeScript code
vitest-unit-testing	Write and maintain TypeScript unit tests with Vitest
vue-components	Build and review Vue components and composables
web-interface-conventions	Build and review usable, accessible web interfaces

Quick start

Using skills

Install or update the global skills and Playwright CLI, including Chromium. Requires Node.js 26 and Vite+ (vp and vpx).

pnpm run setup:skills

Add --verbose for detailed output. Setup prints the full log path and preserves your existing Playwright config.

To install only the skills from this repository:

vpx skills add perdolique/workflow --global --skill '*' --agent universal --yes

Non-standard coding assistant instructions

This repository includes my personal custom instructions for coding assistants. The canonical file is non-standard/codex/AGENTS.md; Copilot-specific files point to it where that setup is useful for my tools.

File	Target	Description
AGENTS.md	Codex	Personal instructions that guide the assistant across projects
config.toml	Codex CLI, IDE, and desktop app	Personal Codex configuration
personal.rules	Codex command policy	Personal Codex execution rules
copilot-instructions.md	GitHub Copilot CLI	Symlink to the canonical Codex instructions

Codex global instructions

Codex reads my global guidance from ~/.codex/AGENTS.md.

mkdir -p ~/.codex
ln -s /path/to/workflow/non-standard/codex/AGENTS.md ~/.codex/AGENTS.md

Codex configuration

Copy the tracked configuration into a new Codex home:

mkdir -p ~/.codex
cp /path/to/workflow/non-standard/codex/config.toml ~/.codex/config.toml

Merge it manually when ~/.codex/config.toml already exists.

Codex command rules

Review and install the tracked personal rules separately:

mkdir -p ~/.codex/rules
cp /path/to/workflow/non-standard/codex/rules/personal.rules \
  ~/.codex/rules/personal.rules

GitHub Copilot CLI instructions

GitHub Copilot CLI reads local user instructions from $HOME/.copilot/copilot-instructions.md.

mkdir -p ~/.copilot
ln -s /path/to/workflow/non-standard/copilot/copilot-instructions.md ~/.copilot/copilot-instructions.md

GitHub Copilot in VS Code

VS Code can use repository-wide instructions from .github/copilot-instructions.md or AGENTS.md. For my user-level prompt instructions, VS Code can also read .instructions.md files from ~/.copilot/instructions/. Those files need applyTo frontmatter to apply automatically, so do not symlink the Codex AGENTS.md file directly as a VS Code instructions file.

mkdir -p ~/.copilot/instructions
{
  printf '%s\n' '---' 'applyTo: "**"' '---' ''
  cat /path/to/workflow/non-standard/codex/AGENTS.md
} > ~/.copilot/instructions/global.instructions.md

Replace /path/to/workflow with the actual path to this repository.

Official references:

• Codex AGENTS.md guidance
• GitHub Copilot CLI custom instructions
• GitHub Copilot custom instructions support
• VS Code custom instructions

Warning

These instructions override assistant defaults and contain opinionated communication style preferences. Review the file before installing.

LSP configuration

The repository includes an LSP (Language Server Protocol) configuration for GitHub Copilot CLI's /lsp command. This configuration enables language-specific features and autocompletion by specifying LSP servers for different file types.

Configuration file: non-standard/copilot/lsp-config.json

Supported language servers:

• TypeScript/JavaScript - typescript-language-server
• Vue - vue-language-server

Installation

Place the configuration file in your Copilot directory:

cp /path/to/workflow/non-standard/copilot/lsp-config.json ~/.copilot/lsp-config.json

Or symlink it:

ln -s /path/to/workflow/non-standard/copilot/lsp-config.json ~/.copilot/lsp-config.json

Replace /path/to/workflow with the actual path to this repository.

Prerequisites

Install the required language servers globally:

npm install -g typescript-language-server typescript
npm install -g @vue/language-server

Make sure the language servers are available in your PATH before using the configuration.

License

Unlicense (unless otherwise specified for individual components)

---

Note

This is a personal collection of opinionated and sometimes quirky skills. Feel free to explore, use, and adapt them for your own projects.