violet-core

Query Violet governance rules, mind facets, and kaomoji data through MCP tools.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/joySUSY/violet-plugin-place --skill violet-core-joysusy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: violet-core
Source: https://github.com/joySUSY/violet-plugin-place/tree/main/plugins/violet-core/skills/violet-core
Command: npx skills add https://github.com/joySUSY/violet-plugin-place --skill violet-core-joysusy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Loading all 17 Violet governance rules at session start consumes roughly 10.6k tokens of context. This Skill replaces that bulk loading with a minimal ~2k token essence plus on-demand MCP queries, so governance data is available without exhausting the context window. ## Core Features & Use Cases - On-Demand Rule Queries: Retrieve any of the 17 rules (e.g., coding-style, security) via violet_get_rule only when needed. - Mind Facet Lookup: List 19 mind facets and fetch details and triggers for a specific facet such as aurora. - Kaomoji & Health Checks: Get kaomoji by emotional category with violet_get_vibe and verify data file integrity with violet_soul_status. - Use Case: Before writing code, query the coding-style rule for standards; after a session compact, run a soul status check to confirm all data files are healthy. ## Quick Start Ask the assistant to list all Violet rules or fetch a specific rule such as security using the violet-ctx MCP tools.

Frequently Asked Questions about violet-core

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Violet rules without loading them all at startup?▼

Use the violet_get_rule MCP tool with a rule key such as coding-style or security to fetch a single rule on demand. The violet_list_rules tool lists all 17 rules with priority and summary so you can pick the right key first.

What MCP tools does the violet-core skill provide?▼

It provides six tools: violet_list_rules, violet_get_rule, violet_list_minds, violet_get_mind, violet_get_vibe, and violet_soul_status. These cover rule queries, mind facet lookup, kaomoji retrieval, and data health checks.

How does violet-core reduce token usage compared to violet-soul-loader?▼

Instead of loading all 17 rules (~10.6k tokens) at startup, a SessionStart hook injects a minimal ~2k token essence. Full rule content is served on demand through the MCP server backed by consolidated JSON data files.

How do I check if Violet data files are healthy after a session compact?▼

Call the violet_soul_status MCP tool or run the /soul-status command. It performs a health check on all consolidated data files and reports any issues.

How do I get kaomoji for a specific emotional category?▼

Call violet_get_vibe with a category argument such as happy. The tool returns fresh kaomoji selections for that emotional category from the vibe data files.