🔥 chore(skills): remove deprecated skills (regenerate via 'mise add-skills')

# 3GPP Skills

Skills for understanding and working with 3GPP data.

## Skills

### @3gpp-basics

General 3GPP organization overview, partnerships, and scope.

### @3gpp-working-groups

Working group nomenclature, tbid/SubTB identifiers, and hierarchy.

### @3gpp-meetings

Meeting structure, naming conventions, and meeting pages.

### @3gpp-tdocs

TDoc patterns, metadata, and FTP/HTTP server access.

### @3gpp-portal-authentication

EOL authentication, AJAX login patterns, and portal data fetching.

### @3gpp-releases

3GPP release structure, versioning, and TSG rounds.

### @3gpp-specifications

TS and TR numbering, spec file formats, and directory structure.

### @3gpp-change-request

Change Request procedure, workflow, status tracking, and CR database.

- [SKILL.md](3gpp-change-request/SKILL.md) - Full CR reference

- [workflow.md](3gpp-change-request/workflow.md) - Quick workflow guide

### @mcp-teddi

MCP usage for TEDDI term and definition search from Copilot chat tools.

### @cli-teddi

CLI usage for teddi-mcp via `uv run` for search, technical body listing, and server mode.

## Cross-Reference Map

| From \\ To | basics | working-groups | meetings | tdocs | portal-auth | releases | specs | change-request |

|-------------------|--------|----------------|----------|-------|-------------|----------|--------|---------------|

| basics | - | X | X | - | X | X | X | X |

| working-groups | X | - | X | - | X | X | X | X |

| meetings | X | X | - | - | X | X | X | X |

| tdocs | X | X | X | - | X | X | X | X |

| portal-auth | X | X | X | - | - | X | X | X |

| releases | X | X | X | - | X | - | X | X |

| specs | X | X | X | - | X | X | - | X |

| change-request | X | X | X | - | X | X | X | - |

## Usage

Use these skills when:

- Implementing features related to 3GPP data crawling

- Understanding 3GPP document and meeting structures

- Parsing TDoc metadata from portal or FTP

- Normalizing working group or subgroup names

- Working with Change Requests and specifications

- Authenticating with 3GPP portal

## Related

- TDoc-Crawler project: AGENTS.md for implementation details

- 3GPP Official: <https://www.3gpp.org/>

---

name: cli-bd

description: Issue tracking using bd (beads) CLI with dependency-aware task management, Dolt-powered version control, and AI-optimized workflows

---

# CLI Tool: Issue Tracking with bd (beads)

## Overview

**bd (beads)** is the issue tracking system for this project. Use it for ALL task tracking - do NOT use markdown TODOs, task lists, or other tracking methods.

## Quick Start

### Check for Ready Work

```bash

# Show unblocked issues

bd ready --json

# Show forgotten issues

bd stale --days 30 --json

```

### Create New Issues

```bash

# Basic issue

bd create "Issue title" -t bug|feature|task -p 0-4 --json

# Issue with dependency

bd create "Issue title" -p 1 --deps discovered-from:bd-123 --json

# Hierarchical subtask (parent epic)

bd create "Subtask" --parent <epic-id> --json

```

### Search and Manage

```bash

# List open issues by priority

bd list --status open --priority 1 --json

# Show specific issue

bd show <id> --json

```

### Claim and Update

```bash

# Claim issue (mark as in-progress)

bd update <id> --status in_progress --json

# Update priority

bd update bd-42 --priority 1 --json

```

### Complete Work

```bash

bd close bd-42 --reason "Completed" --json

```

### Commit (CRITICAL at end of session!)

```bash

bd vc commit -m "session changes"

```

Commits changes to Dolt immediately. Always run at end of work session.

## Why bd?

- **Dependency-aware**: Track blockers and relationships between issues

- **Git-friendly**: Dolt-powered version control with native sync

- **Agent-optimized**: JSON output, ready work detection, discovered-from links

- **Prevents duplicate tracking systems and confusion**

## Issue Types

- `bug` - Something broken

- `feature` - New functionality

- `task` - Work item (tests, docs, refactoring)

- `epic` - Large feature with subtasks

- `chore` - Maintenance (dependencies, tooling)

## Priorities

- `0` - Critical (security, data loss, broken builds)

- `1` - High (major features, important bugs)

- `2` - Medium (default, nice-to-have)

- `3` - Low (polish, optimization)

- `4` - Backlog (future ideas)

## Workflow for AI Agents

1. **Check ready work**: `bd ready` shows unblocked issues

2. **Claim your task atomically**: `bd update <id> --claim`

3. **Work on it**: Implement, test, document

4. **Discover new work?** Create linked issue:

   - `bd create "Found bug" --description="Details about what was found" -p 1 --deps discovered-from:<parent-id>`

5. **Complete**: `bd close <id> --reason "Done"`

## Version Control

bd uses Dolt for version control:

- **Commit changes:** `bd vc commit -m "message"`

- **Push to remote:** `bd vc push`

- **Pull from remote:** `bd vc pull`

- Each write auto-commits to Dolt history

## Important Rules

- ✅ Use bd for ALL task tracking

- ✅ Always use `--json` flag for programmatic use

- ✅ Link discovered work with `discovered-from` dependencies

- ✅ Check `bd ready` before asking "what should I work on?"

- ✅ Run `bd vc commit -m "session changes"` at end of session

- ✅ Test with `BEADS_DB=/tmp/test.db` (don't create test issues in production)

- ❌ Do NOT create markdown TODO lists

- ❌ Do NOT use external issue trackers

- ❌ Do NOT duplicate tracking systems

## GitHub Copilot Integration

If using GitHub Copilot, also create `.github/copilot-instructions.md` for automatic instruction loading. Run `bd onboard` to get content.

## MCP Server (Recommended)

If using Claude or MCP-compatible clients, install **beads MCP server**:

```bash

pip install beads-mcp

```

Add to MCP config (e.g., `~/.config/claude/config.json`):

```json

{

  "beads": {

    "command": "beads-mcp",

    "args": []

  }

}

```

Then use `mcp__beads__*` functions instead of CLI commands.

## Managing AI-Generated Planning Documents

AI assistants often create planning and design documents during development:

- PLAN.md, IMPLEMENTATION.md, ARCHITECTURE.md

- DESIGN.md, CODEBASE_SUMMARY.md, INTEGRATION_PLAN.md

- TESTING_GUIDE.md, TECHNICAL_DESIGN.md, and similar files

**Best Practice: Use a dedicated directory for ephemeral files**

Create `temp/history/` directory in project root:

```

temp/history/

```

Store ALL AI-generated planning/design docs in `temp/history/`. Benefits:

- ✅ Clean repository root

- ✅ Clear separation between ephemeral and permanent documentation

- ✅ Easy to exclude from version control if desired

- ✅ Preserves planning history for archeological research

- ✅ Reduces noise when browsing project

Example `.gitignore` entry:

```gitignore

# AI planning documents (ephemeral)

history/

```

## CLI Help

Run `bd <command> --help` to discover all available flags:

```bash

bd create --help    # Shows --parent, --deps, --assignee, etc.

bd update --help    # Shows all update flags

bd list --help      # Shows search and filter flags

```

## Reference

[beads GitHub](https://github.com/steveyegge/beads)

---

name: documentation-workflow

description: Documentation workflow, structure, and best practices for maintaining project documentation. Use when creating, updating, or refactoring documentation.

---

# Documentation Workflow

## Overview

This skill defines the workflow for maintaining project documentation across multiple audiences (humans and AI coding assistants) and ensuring consistency between code and documentation.

## Documentation Structure

This repository maintains separate documentation for humans and for coding agents:

1. **docs/index.md** - Main documentation entry point (Jekyll-ready)

2. **docs/*.md** - Modular task-oriented user guides (crawl, query, utils, etc.)

3. **README.md** - Project overview and contributor entry points

4. **docs/agents-md/** - Agent-facing modular implementation and workflow guidance

5. **AGENTS.md** - Core guidelines and rules for coding assistants (standalone context)

## Critical Rules

- The modular user documentation in `docs/` **MUST** always be up to date and reflect current CLI behavior

- **AGENTS.md** serves as the primary rule set and context for AI assistants

- When adding or modifying features, update relevant sections in both user docs (`docs/*.md`) and agent docs (`docs/agents-md/`)

- Keep documentation consistent with actual implementation

## Documentation Workflow

### When Adding/Modifying Features

1. **Implement** feature in code

2. **Update** relevant sections in `docs/agents-md/` modular files

3. **Verify** `AGENTS.md` table of contents remains accurate

4. **Test** that all examples in documentation work correctly

5. **Run** linting and formatting on documentation files

### Example Workflow for Adding a New Feature

1. Implement: `src/tdoc_crawler/` - add new component

2. Test: `tests/` - add corresponding tests

3. Update agent docs: `docs/agents-md/` - document new structure/patterns

4. Update human docs (if CLI behavior changed): `docs/QUICK_REFERENCE.md`

5. Verify: `AGENTS.md` - table of contents is current

## Documentation Updates

Focus updates on these key areas:

- **3GPP domain/crawling changes** → Use skills in `.config/skills/3gpp/`

- **Architecture changes** → `docs/agents-md/300_*`

- **Database contract changes** → `docs/agents-md/320_*`

- **Engineering standards** → `docs/agents-md/600_*`

- **Testing approaches** → `docs/agents-md/700_*`

## Documentation Cleanup

Any documentation generated during development should be:

- Integrated into appropriate modular files in `docs/agents-md/`

- Removed from project root after integration

- Kept focused and concise without redundant information

## General Documentation Guidelines

- Use markdown formatting for headings, lists, code blocks, and links

- Use clear and concise language

- Use consistent terminology and naming conventions

- Keep documentation focused on practical guidance for developers

- Ensure all code examples are tested and functional

- Maintain consistency across all modular documentation files

## References

- Jekyll documentation site: https://jekyllrb.com/

- Markdown guide: https://www.markdownguide.org/

---

name: mcp-context7

description: Automatic documentation and library API discovery using Context7 MCP server

---

# Context7 - Automatic Documentation

**If MCP server `context7` is available**, always use it when generating code, setup steps, or library/API documentation.

## When to Use

Use context7 for:

- **Generated code examples**: Any code, configuration, or implementation steps

- **Library API documentation**: Resolve library IDs and get docs automatically

- **Setup instructions**: Installation, configuration, or initialization steps

- **Tool integration**: How to use tools together

## Library API Discovery

When working with a library:

1. **Context7 will automatically**: Identify the library and its usage

2. **Fetch documentation**: Get relevant API docs without you asking explicitly

3. **Provide examples**: Show how to use the library in this project's context

## Example Workflow

When you need to work with a library:

```

1. Mention the library name

2. Context7 resolves library ID

3. Fetches API documentation

4. Provides usage examples

5. You write code using the library

```

## Best Practices

- **Let context7 work**: Don't try to manually resolve library docs

- **Use in context**: Allow context7 to provide project-specific examples

- **Verify examples**: Ensure provided examples work in your project's context

## References

- [Upstash Context7](https://github.com/upstash/context7)

---

name: mcp-desktop-commander

description: File system operations, process management, terminal interaction, and workspace exploration

---

# Desktop Commander

**If MCP server `desktop-commander` is available**, use this tool for file system and terminal operations.

## When to Use

Use desktop-commander for:

- **File system operations**: Create, edit, read directories and files

- **Process management**: Start, stop, and manage terminal processes

- **Search operations**: Search files and content efficiently

- **Workspace exploration**: Navigate and understand workspace structure

- **Terminal interaction**: Execute shell commands and scripts

## Key Capabilities

### File Operations

```python

# List directory contents

list_directory(path, depth=2)

# Read files

read_file(path, offset=0, length=100)

# Write files

write_file(path, content, mode="rewrite" | "append")

# Create directories

create_directory(path)

```

### Process Operations

```python

# Start process

start_process(command, timeout_ms=120000, shell="powershell")

# Read process output

read_process_output(pid, offset=0, length=100)

# Send input to process

interact_with_process(pid, input="command", timeout_ms=8000)

# Terminate process

force_terminate(pid)

```

### Search Operations

```python

# Start file search

start_search(path, pattern, search_type="files" | "content")

# Get search results

get_more_search_results(session_id, offset=0, length=100)

# Stop search

stop_search(session_id)

```

## Best Practices

- **Use for file operations**: Prefer desktop-commander over manual shell commands

- **Batch operations**: Use read_multiple_files for multiple files

- **Error handling**: Handle file permissions and path errors gracefully

- **Process management**: Always terminate processes when done

- **Search efficiently**: Use appropriate search_type for your needs

## References

- [Desktop Commander](https://github.com/wonderwhy-er/DesktopCommanderMCP)