Alqudimi/agent-skills

Mind-Skill: The Cognitive Orchestrator

Mind-Skill is not just a tool; it is the intellectual framework that governs how an agent perceives, analyzes, and executes tasks. It transforms the agent from a reactive processor into a strategic architect, ensuring that every action is deliberate, every skill selection is justified, and every solution is optimized for both depth and efficiency.

When to Invoke Mind-Skill

• Complexity Overload: When a task involves multiple domains or ambiguous requirements.
• Skill Selection Dilemma: When you have many skills and need to choose the "perfect fit" without redundancy.
• Strategic Planning: Before starting any multi-phase project to ensure a logical roadmap.
• Efficiency Optimization: When you need to minimize token usage and maximize output quality.

Core Philosophical Pillars

1. Deep Analysis over Surface Execution

Never rush into a task. Use the task-decomposition.md reference to peel back the layers of a request until the core intent is exposed.

2. Strategic Parsimony (The Zero-Waste Protocol)

Skills are expensive in terms of context and complexity. If a task can be solved with base knowledge, do not activate a skill. If two skills overlap, choose the one with the highest precision-to-weight ratio.

3. Synergistic Orchestration

View skills as instruments in an orchestra. Mind-Skill is the conductor. Ensure that the output of one skill flows seamlessly into the input of the next.

Reference Library (The Intellectual Assets)

Asset	Purpose	Guidance
Thinking Frameworks	thinking-frameworks.md	Apply First Principles, Systems Thinking, and Occam's Razor to your reasoning process.
Skill Selection Matrix	skill-selection-matrix.md	Use the definitive criteria to include or exclude skills from your workflow.
Task Decomposition	task-decomposition.md	Follow the 4-phase protocol to break down macro-objectives into executable micro-tasks.

Operational Tools

• Evaluation Script: Run scripts/skill-evaluator.py to programmatically assess the relevance of available skills to the current task.
• Strategic Blueprint: Use templates/strategic-plan-template.md to document your reasoning and plan before execution. This ensures transparency and logical consistency.

The "Mindful" Workflow

1. Pause & Reflect: Before taking any action, invoke Mind-Skill to analyze the user's request.
2. Deconstruct: Use task-decomposition.md to identify the functional modules of the task.
3. Audit Skills: Review your available skills against the skill-selection-matrix.md.
4. Draft Blueprint: Fill out the strategic-plan-template.md (internally or as a note).
5. Execute with Precision: Only use the skills identified in your blueprint.
6. Verify: Review the final output against the original "Core Problem" identified in Phase 1.

---

"Intelligence is not the ability to use every tool, but the wisdom to use only the right ones."