meta

Data Community

Skill notes

Critical best practices

Keep skills focused - one capability per skill Write specific descriptions - include actual terms users would mention Test activation - verify Claude invokes it when expected Use allowed-tools - restrict permissions for security

Description examples

❌ Bad: "Helps with data" ✅ Good: "Analyze Excel spreadsheets, generate pivot tables, create charts. Use when working with .xlsx files." ❌ Bad: "Manages configuration" ✅ Good: "Read and update YAML/JSON config files. Use when modifying settings, environment variables, or application configuration."

Debugging checklist

If Claude doesn't use your skill: Description lacks trigger terms users would say YAML syntax errors (check --- markers, indentation) Description not specific enough about WHEN to use it Wrong file path or permissions

Finding and fixing frontmatter issues

Check if frontmatter exists: Common frontmatter problems: Missing frontmatter block - File starts with # instead of --- Fix: Add YAML block at top of file Missing closing --- - Only one --- marker

Systematic skill debugging workflow

When debugging skills that aren't working: List all skills - Verify skill exists Check frontmatter - Validate YAML structure Verify required fields - Ensure name and description exist name: must match directory name

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Data
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@majiayu000 · MIT
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
  • Env read
Network behavior
Local-only
Install commands
None (reference only)

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

Output preview meta.preview
# Description examples

❌ Bad: "Helps with data" ✅ Good: "Analyze Excel spreadsheets, generate pivot tables, create charts. Use when working with .xlsx files." ❌ Bad: "Manages configuration" ✅ Good: "Read and update YAML/JSON config files. Use when modifying settings, environment variables, or application configuration."

Discussion

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