Skill-Agents
ntaffzii/Skill-Agents
Personal AI-agent skills, workflows, prompts, and setup guides for local LLMs and MCP-powered assistants.
Instalação
npx convez-ai ntaffzii/Skill-Agents1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Skill Agents
Personal AI-agent skills, workflows, prompts, and setup guides for using AI assistants with local tools.
This repo is the skill and workflow layer. It tells an AI agent how to work: how to plan, debug, review code, organize Obsidian notes, draft Notion payloads, improve prompts, route skills, and run personal daily workflows.
For executable MCP tools, use the companion repo:
Skill-Agents = skills, workflows, docs, examples, provider config
ai-desk-tools = MCP server, Python tools, tests, runtime safety policy
local-llm = llama.cpp Router, FastAPI Orchestrator, Docker deployment
Recommended Local LLM repository name: ntaffzii/local-llm-orchestrator.
Who This Is For
Use this repo if you want an AI agent to:
- follow reusable
SKILL.mdinstructions - use workflow playbooks such as
ship-featureordaily-personal-agent - work across Codex, Claude, ChatGPT, Gemini, LM Studio, local LLMs, and MCP clients
- route tasks to the right skill/workflow before loading context
- connect personal notes, Notion, Obsidian, memory, RAG, and MCP tools
- keep personal automation safe with draft-only and read-only defaults
Companion Repo
This repo does not need to contain the MCP server when published separately.
Install or clone the MCP tools from:
Typical setup:
1. Clone Skill-Agents for skills/workflows/docs.
2. Clone ai-desk-tools for MCP tools.
3. Configure your AI client to run ai-desk-tools/server.py.
4. Tell your local LLM or agent to use Skill-Agents prompts and workflows.
Quick Start
Clone this repo:
git clone https://github.com/ntaffzii/Skill-Agents.git
cd Skill-Agents
Read first:
- QUICKSTART.md
- docs/COMPLETE_LOCAL_AI_SYSTEM.md
- docs/PROJECT_GUIDE.md
- docs/USAGE_FOR_PERSONAL_AND_OTHERS.md
Then clone MCP tools:
git clone https://github.com/ntaffzii/ai-desk-tools.git
cd ai-desk-tools
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Configure LM Studio, Claude Desktop, or another MCP client to run:
ai-desk-tools/server.py
Install Skills
If your agent supports npx skills:
npx skills add ntaffzii/Skill-Agents
Manual install for Codex-style skills:
cp -R skills/* ~/.codex/skills/
Manual install for Claude Code-style skills:
cp -R skills/* ~/.claude/skills/
On Windows PowerShell, adjust the target path:
Copy-Item -Recurse .\skills\* "$env:USERPROFILE\.codex\skills\"
Local LLM Usage
For LM Studio, Ollama, llama.cpp, vLLM, or any local LLM that does not have native skill loading, use:
examples/local-llm-agent-prompt.md
Recommended flow:
User request
-> skill-runtime.route_request
-> prompt-improver if unclear
-> skill-runtime.build_agent_context
-> use recommended toolset/tools
-> answer with verification
The skill-runtime and prompt-improver tools live in:
LM Studio MCP Setup
- Clone and install ntaffzii/ai-desk-tools
- Open LM Studio
- Go to
Program > Install > Edit mcp.json - Add a server pointing to
ai-desk-tools/server.py
Example config is in:
examples/lm-studio-mcp-config.json
For model/provider settings, see:
- config.json
- docs/CONFIG_JSON_GUIDE.md
- docs/LOCAL_LLM_SETTINGS.md
- docs/PROMPT_IMPROVER_LOCAL_MODEL.md
Recommended prompt-improver model when available:
LFM2.5-8B-A1B
It is recommended, not required.
Repo Layout
Skill-Agents/
Skill.md/ portable model-neutral skills
skills/ local skill folders with SKILL.md
workflows/ ordered workflow playbooks
data/ tools/toolsets/workflows registry metadata
docs/ guides and usage docs
examples/ prompts and MCP client examples
scripts/ validators and repo utilities
config.json provider/model/preset reference
Main Workflows
ship-feature- implement and verify a feature end to enddebug-regression- reproduce, diagnose, fix, and verify a regressionreview-pr- review a diff or PR with findings firstobsidian-vault-cleanup- organize Obsidian notes safelycreate-new-skill- create a new reusable skillbuild-mcp-tool- design a new MCP toolresearch-report- create sourced research reportsdaily-personal-agent- build a personal daily planpersonal-knowledge-sync- connect Obsidian, Notion, memory, and RAG
Skill Categories
engineering/- diagnose, TDD, code review, architecture reviewresearch/- news, GitHub skill research, project discoveryproductivity/- handoff, prompt improvement, reports, automation, inbox triageobsidian/- Markdown, Canvas, vault workflow, Notion bridgemisc/- skill and MCP tool managementpersonal/- private/personal preferences and daily-agent workflowin-progress/- draft skillsdeprecated/- retired skills with replacement guidance
Portable Skill.md
Skill.md/ contains portable skills that can be copied into other agents:
universal-agent-operating-systemmodel-portability-adaptertool-agnostic-mcp-routingcross-model-handoff
Use these when a provider does not support native skill folders.
Common Prompts
Daily planning:
Use daily-personal-agent. Build today's plan from my Obsidian notes, Notion context, memory, calendar, inbox, chat, and open issues. Draft replies but do not send anything.
Obsidian to Notion:
Use personal-knowledge-sync. Treat Obsidian as source of truth. Draft Notion payloads only and preserve tags, wikilinks, aliases, and source paths.
Code work:
Use ship-feature. Inspect docs, repo index, tests, CI, and git before editing. Verify with the narrowest test.
Review:
Use review-pr. Inspect the diff and related files. Report findings first with severity, file, and line reference.
Local LLM routing:
Use skill-runtime first. Route this request, improve it only if unclear, then load selected workflow and skills.
Documentation
- QUICKSTART.md
- docs/PROJECT_GUIDE.md
- docs/USAGE_FOR_PERSONAL_AND_OTHERS.md
- docs/SKILL_RUNTIME_FLOW.md
- docs/LOCAL_LLM_SETTINGS.md
- docs/PROMPT_IMPROVER_LOCAL_MODEL.md
- docs/CONFIG_JSON_GUIDE.md
- docs/TOOLS_INVENTORY.md
- docs/MCP_API_SERVER.md
- docs/WEB_CAPTURE_PROVIDERS.md
- docs/FINANCE_MARKET_PROVIDERS.md
- NOTICE.md
Validate
From the combined workspace:
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\validate-all.ps1
This validates:
- tool registry metadata
- toolsets
- workflows
skills/**/SKILL.mdSkill.md/**/SKILL.md- MCP tool Python syntax and tests when tools are present
Attribution
This repo is original work inspired by public agent-skill and MCP repositories. It is not an official fork, template, distribution, or endorsement of those projects.
See NOTICE.md for attribution and license notes.
License
See LICENSE.