Skills Management¶

# create_skill.py
import nexus

# Connect to server
nx = nexus.connect(config={
    "url": "http://localhost:2026",
    "api_key": "your-api-key"
})

# Create skill content
skill_content = """---
name: git-best-practices
description: Git workflow and best practices for team collaboration
version: 1.0.0
author: DevOps Team
created_at: 2025-01-15T10:00:00Z
tier: tenant
---

# Git Best Practices

## Overview
Guidelines for effective Git workflows in team environments.

## Branch Naming
- `feature/` - New features
- `bugfix/` - Bug fixes
- `hotfix/` - Production hotfixes
- `release/` - Release preparation

## Commit Messages
Follow conventional commits:
- `feat:` - New feature
- `fix:` - Bug fix
- `docs:` - Documentation
- `refactor:` - Code refactoring

## Example Workflow

\```bash
# Create feature branch
git checkout -b feature/add-login

# Make changes and commit
git add .
git commit -m "feat: add user login page"

# Push and create PR
git push origin feature/add-login
\```

## Code Review Guidelines
- Review within 24 hours
- Two approvals required
- Run tests before approval
- Check for security issues
"""

# Create skill directory
nx.mkdir("/workspace/.nexus/skills/git-best-practices", parents=True, exist_ok=True)

# Write skill file
nx.write("/workspace/.nexus/skills/git-best-practices/SKILL.md", skill_content.encode())

print("✅ Skill created: git-best-practices")

# discover_skills.py
import asyncio
import nexus
from nexus.skills.registry import SkillRegistry

async def main():
    # Connect to Nexus
    nx = nexus.connect(config={
        "url": "http://localhost:2026",
        "api_key": "your-api-key"
    })

    # Create skill registry
    registry = SkillRegistry(filesystem=nx)

    # Discover all skills
    count = await registry.discover(tiers=["agent", "tenant", "system"])
    print(f"📚 Discovered {count} total skills\n")

    # List skills by tier
    print("🔹 Agent Skills (Personal):")
    agent_skills = registry.list_skills(tier="agent")
    for skill_name in agent_skills:
        print(f"  • {skill_name}")

    print("\n🔸 Tenant Skills (Organization):")
    tenant_skills = registry.list_skills(tier="tenant")
    for skill_name in tenant_skills:
        print(f"  • {skill_name}")

    print("\n🔻 System Skills (Global):")
    system_skills = registry.list_skills(tier="system")
    for skill_name in system_skills:
        print(f"  • {skill_name}")

asyncio.run(main())

# read_skill.py
import asyncio
import nexus
from nexus.skills.registry import SkillRegistry

async def main():
    nx = nexus.connect(config={
        "url": "http://localhost:2026",
        "api_key": "your-api-key"
    })

    registry = SkillRegistry(filesystem=nx)
    await registry.discover()

    # Get specific skill
    skill = await registry.get_skill("git-best-practices")

    # Access metadata
    print(f"📖 Skill: {skill.metadata.name}")
    print(f"   Version: {skill.metadata.version}")
    print(f"   Author: {skill.metadata.author}")
    print(f"   Description: {skill.metadata.description}")
    print(f"   Tier: {skill.metadata.tier}")

    # Read the content
    print(f"\n📄 Content Preview:")
    print(skill.content[:300] + "...")

asyncio.run(main())

# generate_skill.py
import asyncio
import os
from nexus.remote import RemoteNexusFS
from nexus_skill_seekers.plugin import SkillSeekersPlugin

async def main():
    # Connect to Nexus server
    nx = RemoteNexusFS("http://localhost:2026", api_key=os.getenv("NEXUS_API_KEY"))

    # Initialize Skill Seekers plugin
    plugin = SkillSeekersPlugin(nx)

    # Generate skill from Python docs
    print("🔍 Generating skill from Python json module docs...")

    skill_path = await plugin.generate_skill(
        url="https://docs.python.org/3/library/json.html",
        name="python-json-module",
        tier="agent",
        use_ai=True  # Enable AI enhancement for better structure
    )

    print(f"✅ Skill created: {skill_path}")
    print("   The skill is now available in your agent tier!")

asyncio.run(main())

# search_skills.py
import asyncio
import nexus
from nexus.skills.registry import SkillRegistry

async def main():
    nx = nexus.connect(config={
        "url": "http://localhost:2026",
        "api_key": "your-api-key"
    })

    registry = SkillRegistry(filesystem=nx)
    await registry.discover()

    # Search by keyword
    query = "git"
    results = [
        name for name in registry.list_skills()
        if query.lower() in name.lower()
    ]

    print(f"🔍 Found {len(results)} skills matching '{query}':")
    for name in results:
        skill = await registry.get_skill(name)
        print(f"  • {name}")
        print(f"    Tier: {skill.metadata.tier}")
        print(f"    Description: {skill.metadata.description}")

asyncio.run(main())

# publish_skill.py
import asyncio
import nexus

async def main():
    nx = nexus.connect(config={
        "url": "http://localhost:2026",
        "api_key": "your-api-key"
    })

    # Read agent-tier skill
    agent_skill = nx.read("/workspace/.nexus/skills/git-best-practices/SKILL.md")

    # Create in tenant tier
    nx.mkdir("/shared/skills/git-best-practices", parents=True, exist_ok=True)
    nx.write("/shared/skills/git-best-practices/SKILL.md", agent_skill)

    # Grant team read access
    nx.rebac_create(
        subject=("group", "engineering"),
        relation="can_read",
        object=("file", "/shared/skills/git-best-practices"),
        tenant_id="default"
    )

    print("✅ Skill published to tenant tier")
    print("   Team members can now discover and use it!")

asyncio.run(main())

#!/usr/bin/env python3
"""
Build a team skill library from documentation
"""
import asyncio
import os
from nexus.remote import RemoteNexusFS
from nexus_skill_seekers.plugin import SkillSeekersPlugin

async def main():
    # Connect to server
    nx = RemoteNexusFS("http://localhost:2026", api_key=os.getenv("NEXUS_API_KEY"))
    plugin = SkillSeekersPlugin(nx)

    # Team's tech stack documentation
    docs = {
        "fastapi": "https://fastapi.tiangolo.com/",
        "pydantic": "https://docs.pydantic.dev/",
        "sqlalchemy": "https://docs.sqlalchemy.org/",
        "pytest": "https://docs.pytest.org/",
    }

    print("🚀 Building team skill library...")
    print(f"   Generating {len(docs)} skills from documentation\n")

    for name, url in docs.items():
        print(f"📖 Processing: {name}")
        try:
            skill_path = await plugin.generate_skill(
                url=url,
                name=f"lib-{name}",
                tier="tenant",  # Share with team
                use_ai=True
            )
            print(f"   ✅ Created: {skill_path}\n")
        except Exception as e:
            print(f"   ❌ Failed: {e}\n")

    print("🎉 Team skill library complete!")
    print("\nTeam members can now:")
    print("  • nexus skills list --tier tenant")
    print("  • nexus skills info lib-fastapi")
    print("  • Use skills in AI agent conversations")

if __name__ == "__main__":
    asyncio.run(main())

# Check API keys
import os
print(f"OpenRouter: {bool(os.getenv('OPENROUTER_API_KEY'))}")
print(f"Anthropic: {bool(os.getenv('ANTHROPIC_API_KEY'))}")
print(f"OpenAI: {bool(os.getenv('OPENAI_API_KEY'))}")

# Verify one is set
# Plugin auto-falls back to basic generation if no key

# ✅ Good: Descriptive, clear
"api-authentication-guide"
"python-testing-pytest"
"deployment-kubernetes-helm"

# ❌ Bad: Vague, unclear
"stuff"
"notes"
"doc1"