reviewing skills

Engineering Community

Skill notes

When to review

Review the relevant skills and instructions after any work that changes: Public API surface — new methods, renamed parameters, changed signatures Build or test infrastructure — new solution files, changed filters, new TFMs Architecture — new projects, moved files, changed conventions Code generation — new keywords, changed handler behaviour, new CLI options

What to check

For each skill touched by your changes, verify these in order:

1. Code examples compile and are accurate

Every code block in a skill should use real types, real method signatures, and real parameter names from the current codebase. The most common failure mode is fabricated or stale API usage — a method that was renamed, a parameter that was added, or a constructor whose signature changed. To verify, pick each code example and check the actual source: Common drift patterns: Constructor gains a new required parameter (skill example silently omits it)

2. Numeric values and thresholds match source

When a skill states a specific number (priority value, buffer threshold, step count, character limit), verify it against the source constant or definition. These drift silently when someone changes a constant without updating the documentation.

3. Scope boundaries are still correct

Check the USE FOR / DO NOT USE FOR fields in the YAML frontmatter. After adding a new feature or project, an existing skill's scope may need updating — either to include the new area or to explicitly redirect to a new skill.

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@tomevault-io · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Windows
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview reviewing-skills.preview
# 1. Code examples compile and are accurate

# Find the real signature
grep -rn "public.*MethodName" src/

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.