# Matrix Warnings

> This skill should be used when the user asks to "add warning", "remove warning", "list warnings", "check file warning", "check package warning", "manage grudges", or needs to manage file and package warnings in Matrix. Use when this capability is needed.

- Skill: `tomevault-io/matrix-warnings` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/matrix-warnings`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/matrix-warnings/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/matrix-warnings

---


# Matrix Warnings

Manage "personal grudges" - warnings for problematic files or packages.

Parse user arguments from the skill invocation (text after the trigger phrase).

Use the `matrix_warn` tool with the appropriate action parameter.

## Actions

**List warnings** (default, or "list"):
Use `matrix_warn` with `action: "list"` to show all warnings.
- Optional: `type: "file"` or `type: "package"` to filter
- Optional: `repoOnly: true` to show only repo-specific warnings

**Add warning** ("add <type> <target> <reason>"):
Use `matrix_warn` with `action: "add"` and:
- type: "file" or "package"
- target: file path/pattern or package name
- reason: why this is problematic
- severity: "info", "warn", or "block" (default: warn)
- repoSpecific: true if warning should only apply to current repo

**Remove warning** ("remove <target>" or "rm <target>"):
Use `matrix_warn` with `action: "remove"` and either:
- id: the warning ID to remove, or
- type + target: to remove by type and target

**Check target** ("check <target>"):
Use `matrix_warn` with `action: "check"` and:
- type: "file" or "package"
- target: file path or package name

## Examples

- `/matrix:warn` - list all warnings
- `/matrix:warn add file src/legacy/*.ts "Deprecated, do not modify"`
- `/matrix:warn add package moment "Use date-fns instead"`
- `/matrix:warn remove moment`
- `/matrix:warn check .env`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/ojowwalker77) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->