skillmind 0.3.2__tar.gz → 0.3.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. {skillmind-0.3.2 → skillmind-0.3.3}/.gitignore +52 -52
  2. {skillmind-0.3.2 → skillmind-0.3.3}/CLAUDE.md +82 -82
  3. {skillmind-0.3.2 → skillmind-0.3.3}/LICENSE +21 -21
  4. {skillmind-0.3.2 → skillmind-0.3.3}/PKG-INFO +12 -4
  5. {skillmind-0.3.2 → skillmind-0.3.3}/README.md +434 -426
  6. {skillmind-0.3.2 → skillmind-0.3.3}/configs/default.yml +40 -40
  7. {skillmind-0.3.2 → skillmind-0.3.3}/docs/assets/logo.svg +42 -42
  8. {skillmind-0.3.2 → skillmind-0.3.3}/pyproject.toml +1 -1
  9. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/__init__.py +3 -3
  10. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/cli/__init__.py +1 -1
  11. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/cli/main.py +508 -508
  12. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/config.py +156 -156
  13. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/context.py +218 -218
  14. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/embeddings.py +126 -126
  15. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/exporters/__init__.py +5 -5
  16. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/exporters/obsidian.py +660 -660
  17. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/listener.py +303 -303
  18. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/mcp/__init__.py +1 -1
  19. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/mcp/server.py +771 -771
  20. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/migration.py +201 -201
  21. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/models.py +112 -112
  22. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/review.py +186 -186
  23. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/sanitizer.py +233 -233
  24. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/setup.py +380 -380
  25. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/__init__.py +45 -45
  26. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/base.py +148 -148
  27. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/chroma_store.py +184 -184
  28. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/faiss_store.py +286 -286
  29. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/pinecone_store.py +204 -204
  30. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/qdrant_store.py +256 -256
  31. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/store/supabase_store.py +267 -267
  32. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/trainer.py +292 -292
  33. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/video/__init__.py +1 -1
  34. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/video/screen_recorder.py +207 -207
  35. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/video/video_learner.py +454 -454
  36. {skillmind-0.3.2 → skillmind-0.3.3}/src/skillmind/video/youtube_learner.py +632 -632
  37. {skillmind-0.3.2 → skillmind-0.3.3}/tests/conftest.py +146 -146
  38. {skillmind-0.3.2 → skillmind-0.3.3}/tests/test_context.py +87 -87
  39. {skillmind-0.3.2 → skillmind-0.3.3}/tests/test_listener.py +92 -92
  40. {skillmind-0.3.2 → skillmind-0.3.3}/tests/test_migration.py +126 -126
  41. {skillmind-0.3.2 → skillmind-0.3.3}/tests/test_models.py +121 -121
  42. {skillmind-0.3.2 → skillmind-0.3.3}/tests/test_stores.py +219 -219
  43. {skillmind-0.3.2 → skillmind-0.3.3}/tests/test_trainer.py +147 -147
  44. skillmind-0.3.2/.claude/settings.local.json +0 -27
  45. skillmind-0.3.2/.playwright-mcp/console-2026-04-08T08-53-35-219Z.log +0 -1
  46. skillmind-0.3.2/.playwright-mcp/page-2026-04-08T08-53-36-780Z.yml +0 -205
  47. skillmind-0.3.2/test_sanitizer_result.txt +0 -10
  48. skillmind-0.3.2/tests/test_sanitizer_quick.py +0 -22
  49. {skillmind-0.3.2 → skillmind-0.3.3}/.github/FUNDING.yml +0 -0
  50. {skillmind-0.3.2 → skillmind-0.3.3}/docs/assets/favicon-192.png +0 -0
  51. {skillmind-0.3.2 → skillmind-0.3.3}/docs/assets/favicon.ico +0 -0
  52. {skillmind-0.3.2 → skillmind-0.3.3}/docs/assets/favicon.png +0 -0
  53. {skillmind-0.3.2 → skillmind-0.3.3}/docs/assets/logo.png +0 -0
  54. {skillmind-0.3.2 → skillmind-0.3.3}/tests/__init__.py +0 -0
{skillmind-0.3.2 → skillmind-0.3.3}/.gitignore RENAMED
@@ -1,52 +1,52 @@
1
- # Python
2
- __pycache__/
3
- *.py[cod]
4
- *$py.class
5
- *.so
6
- *.egg-info/
7
- dist/
8
- build/
9
- .eggs/
10
-
11
- # Virtual environments
12
- venv/
13
- .venv/
14
- env/
15
-
16
- # IDE
17
- .idea/
18
- .vscode/
19
- *.swp
20
- *.swo
21
-
22
- # Environment / secrets
23
- .env
24
- .env.local
25
- .env.*.local
26
-
27
- # Runtime data
28
- .skillmind/
29
- *.db
30
- *.sqlite3
31
-
32
- # Test / coverage
33
- .pytest_cache/
34
- .coverage
35
- htmlcov/
36
- .mypy_cache/
37
-
38
- # OS
39
- .DS_Store
40
- Thumbs.db
41
- desktop.ini
42
-
43
- # Recordings (runtime)
44
- recordings/
45
-
46
- # Obsidian vaults (user data, not code)
47
- test_vault/
48
- *_vault/
49
-
50
- # Website (private repo)
51
- website/
52
- generate_pdfs.py
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+ *.so
6
+ *.egg-info/
7
+ dist/
8
+ build/
9
+ .eggs/
10
+
11
+ # Virtual environments
12
+ venv/
13
+ .venv/
14
+ env/
15
+
16
+ # IDE
17
+ .idea/
18
+ .vscode/
19
+ *.swp
20
+ *.swo
21
+
22
+ # Environment / secrets
23
+ .env
24
+ .env.local
25
+ .env.*.local
26
+
27
+ # Runtime data
28
+ .skillmind/
29
+ *.db
30
+ *.sqlite3
31
+
32
+ # Test / coverage
33
+ .pytest_cache/
34
+ .coverage
35
+ htmlcov/
36
+ .mypy_cache/
37
+
38
+ # OS
39
+ .DS_Store
40
+ Thumbs.db
41
+ desktop.ini
42
+
43
+ # Recordings (runtime)
44
+ recordings/
45
+
46
+ # Obsidian vaults (user data, not code)
47
+ test_vault/
48
+ *_vault/
49
+
50
+ # Website (private repo)
51
+ website/
52
+ generate_pdfs.py
{skillmind-0.3.2 → skillmind-0.3.3}/CLAUDE.md RENAMED
@@ -1,82 +1,82 @@
1
- # SkillMind
2
-
3
- **Active Skill Listener & Trainer** — structured memory layer for AI coding assistants.
4
-
5
- ## What is this?
6
-
7
- SkillMind replaces flat markdown memory files with a vector-database-backed memory system that:
8
- - **Listens** to git events, file changes, and conversations
9
- - **Trains** by auto-classifying, deduplicating, and consolidating knowledge
10
- - **Surfaces** only relevant context per conversation (not everything)
11
-
12
- ## Architecture
13
-
14
- ```
15
- src/skillmind/
16
- ├── models.py # Memory, QueryFilter, QueryResult (Pydantic)
17
- ├── config.py # SkillMindConfig (YAML-based)
18
- ├── embeddings.py # EmbeddingEngine (sentence-transformers | openai)
19
- ├── trainer.py # Auto-classify, dedup, merge, consolidate
20
- ├── listener.py # GitListener, FileListener, ConversationListener
21
- ├── context.py # ContextGenerator — dynamic context for Claude Code
22
- ├── migration.py # Import existing Claude Code markdown memories
23
- ├── store/
24
- │ ├── base.py # Abstract MemoryStore interface
25
- │ ├── chroma_store.py # ChromaDB backend (default)
26
- │ ├── pinecone_store.py # Pinecone backend
27
- │ ├── supabase_store.py # Supabase/pgvector backend
28
- │ ├── qdrant_store.py # Qdrant backend
29
- │ └── faiss_store.py # FAISS + JSON backend
30
- ├── exporters/
31
- │ ├── __init__.py
32
- │ └── obsidian.py # Obsidian vault exporter (Karpathy wiki pattern)
33
- ├── mcp/
34
- │ └── server.py # MCP server (25+ tools for Claude Code)
35
- └── cli/
36
- └── main.py # CLI (click-based)
37
- ```
38
-
39
- ## Key Commands
40
-
41
- ```bash
42
- pip install -e ".[chroma]" # Install with Chroma backend
43
- skillmind init --backend chroma # Initialize
44
- skillmind import # Import existing Claude Code memories
45
- skillmind remember "content" # Store memory
46
- skillmind recall "query" # Semantic search
47
- skillmind list # List all
48
- skillmind consolidate # Cleanup
49
- skillmind serve # Start MCP server
50
- skillmind export ~/MyWiki # Export to Obsidian vault
51
- skillmind sync # Incremental sync to vault
52
- ```
53
-
54
- ## Store Backends
55
-
56
- All 5 implement the same `MemoryStore` interface (add, query, get, update, delete, list_all, count, clear):
57
-
58
- | Backend | Best for | Requires |
59
- |---------|----------|----------|
60
- | **chroma** | Solo dev, local, default | `pip install chromadb` |
61
- | **faiss** | Offline, air-gapped, fastest | `pip install faiss-cpu` |
62
- | **qdrant** | Self-hosted or cloud, great filtering | Qdrant server |
63
- | **pinecone** | Multi-device cloud sync | API key |
64
- | **supabase** | SQL + vectors, team sharing | Supabase project |
65
-
66
- ## MCP Server Tools
67
-
68
- 10 tools exposed via FastMCP: `remember`, `recall`, `forget`, `update_memory`, `context`, `consolidate`, `memory_stats`, `list_memories`, `import_markdown_memories`.
69
-
70
- ## Memory Types
71
-
72
- - **user** — role, preferences, expertise
73
- - **feedback** — corrections, confirmed approaches
74
- - **project** — deadlines, client context, status (auto-expires 90d)
75
- - **reference** — external URLs, dashboards, wikis
76
- - **skill** — patterns, workflows, how-tos
77
-
78
- ## Testing
79
-
80
- ```bash
81
- pytest tests/ -v
82
- ```
1
+ # SkillMind
2
+
3
+ **Active Skill Listener & Trainer** — structured memory layer for AI coding assistants.
4
+
5
+ ## What is this?
6
+
7
+ SkillMind replaces flat markdown memory files with a vector-database-backed memory system that:
8
+ - **Listens** to git events, file changes, and conversations
9
+ - **Trains** by auto-classifying, deduplicating, and consolidating knowledge
10
+ - **Surfaces** only relevant context per conversation (not everything)
11
+
12
+ ## Architecture
13
+
14
+ ```
15
+ src/skillmind/
16
+ ├── models.py # Memory, QueryFilter, QueryResult (Pydantic)
17
+ ├── config.py # SkillMindConfig (YAML-based)
18
+ ├── embeddings.py # EmbeddingEngine (sentence-transformers | openai)
19
+ ├── trainer.py # Auto-classify, dedup, merge, consolidate
20
+ ├── listener.py # GitListener, FileListener, ConversationListener
21
+ ├── context.py # ContextGenerator — dynamic context for Claude Code
22
+ ├── migration.py # Import existing Claude Code markdown memories
23
+ ├── store/
24
+ │ ├── base.py # Abstract MemoryStore interface
25
+ │ ├── chroma_store.py # ChromaDB backend (default)
26
+ │ ├── pinecone_store.py # Pinecone backend
27
+ │ ├── supabase_store.py # Supabase/pgvector backend
28
+ │ ├── qdrant_store.py # Qdrant backend
29
+ │ └── faiss_store.py # FAISS + JSON backend
30
+ ├── exporters/
31
+ │ ├── __init__.py
32
+ │ └── obsidian.py # Obsidian vault exporter (Karpathy wiki pattern)
33
+ ├── mcp/
34
+ │ └── server.py # MCP server (25+ tools for Claude Code)
35
+ └── cli/
36
+ └── main.py # CLI (click-based)
37
+ ```
38
+
39
+ ## Key Commands
40
+
41
+ ```bash
42
+ pip install -e ".[chroma]" # Install with Chroma backend
43
+ skillmind init --backend chroma # Initialize
44
+ skillmind import # Import existing Claude Code memories
45
+ skillmind remember "content" # Store memory
46
+ skillmind recall "query" # Semantic search
47
+ skillmind list # List all
48
+ skillmind consolidate # Cleanup
49
+ skillmind serve # Start MCP server
50
+ skillmind export ~/MyWiki # Export to Obsidian vault
51
+ skillmind sync # Incremental sync to vault
52
+ ```
53
+
54
+ ## Store Backends
55
+
56
+ All 5 implement the same `MemoryStore` interface (add, query, get, update, delete, list_all, count, clear):
57
+
58
+ | Backend | Best for | Requires |
59
+ |---------|----------|----------|
60
+ | **chroma** | Solo dev, local, default | `pip install chromadb` |
61
+ | **faiss** | Offline, air-gapped, fastest | `pip install faiss-cpu` |
62
+ | **qdrant** | Self-hosted or cloud, great filtering | Qdrant server |
63
+ | **pinecone** | Multi-device cloud sync | API key |
64
+ | **supabase** | SQL + vectors, team sharing | Supabase project |
65
+
66
+ ## MCP Server Tools
67
+
68
+ 10 tools exposed via FastMCP: `remember`, `recall`, `forget`, `update_memory`, `context`, `consolidate`, `memory_stats`, `list_memories`, `import_markdown_memories`.
69
+
70
+ ## Memory Types
71
+
72
+ - **user** — role, preferences, expertise
73
+ - **feedback** — corrections, confirmed approaches
74
+ - **project** — deadlines, client context, status (auto-expires 90d)
75
+ - **reference** — external URLs, dashboards, wikis
76
+ - **skill** — patterns, workflows, how-tos
77
+
78
+ ## Testing
79
+
80
+ ```bash
81
+ pytest tests/ -v
82
+ ```
{skillmind-0.3.2 → skillmind-0.3.3}/LICENSE RENAMED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Antonio Blago
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Antonio Blago
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
{skillmind-0.3.2 → skillmind-0.3.3}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: skillmind
3
- Version: 0.3.2
3
+ Version: 0.3.3
4
4
  Summary: Active Skill Listener & Trainer — structured memory layer for AI coding assistants
5
5
  Project-URL: Homepage, https://skill-mind.com
6
6
  Project-URL: Documentation, https://skill-mind.com/en/quickstart/
@@ -455,15 +455,15 @@ SkillMind works great alongside other MCP servers:
455
455
 
456
456
  | MCP Server | What it adds | Install |
457
457
  |---|---|---|
458
- | **[Visibly AI MCP](https://pypi.org/project/visiblyai-mcp-server/)** | SEO skills: keyword research, backlinks, site audit, GSC queries, on-page analysis | `pip install visiblyai-mcp-server` |
458
+ | **[Visibly AI MCP](https://www.antonioblago.com/de/entwickler/mcp)** | SEO skills: keyword research, backlinks, site audit, GSC queries, on-page analysis | Hosted MCP — no install; add HTTP config to `settings.json` |
459
459
  | **[Notion MCP](https://mcp.notion.com/)** | Read/write Notion pages, databases, todos | Built-in |
460
460
  | **[Playwright MCP](https://github.com/anthropics/mcp-playwright)** | Browser automation, screenshots, web scraping | Built-in |
461
461
 
462
462
  ### Example: SEO Memory + Skills
463
463
 
464
464
  ```bash
465
- # Install both
466
- pip install skillmind[pinecone,mcp] visiblyai-mcp-server
465
+ # SkillMind installs locally; Visibly AI is a hosted MCP (no install needed)
466
+ pip install skillmind[pinecone,mcp]
467
467
  ```
468
468
 
469
469
  ```json
@@ -485,6 +485,14 @@ pip install skillmind[pinecone,mcp] visiblyai-mcp-server
485
485
 
486
486
  SkillMind remembers your SEO preferences, client keywords, and audit findings. Visibly AI provides the live SEO data. Together: persistent SEO intelligence.
487
487
 
488
+ ## Used by
489
+
490
+ ### [peec-ai-skills](https://github.com/AntonioBlago/peec-ai-skills)
491
+
492
+ A Claude Code skill repository for **Peec AI** (brand-visibility tracking in LLM search) that uses SkillMind as its **cross-project memory layer**. The `skillmind-learner` skill writes causal, evidence-backed patterns to SkillMind after a Peec AI growth-loop outcome is measured, and recalls matching patterns as priors for the growth-agent orchestrator on the next run — so lessons learned on project A inform decisions on project B.
493
+
494
+ See [`skills/skillmind-learner/SKILL.md`](https://github.com/AntonioBlago/peec-ai-skills/blob/main/skills/skillmind-learner/SKILL.md) for the full integration contract (read vs. write mode, required tags, pattern schema, handoff points from the other 5 Peec skills).
495
+
488
496
  ## Contributing
489
497
 
490
498
  PRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).