Big News: Socket raises $60M Series C at a $1B valuation to secure software supply chains for AI-driven development.Announcement
Sign In

@sysmanager/sys-skills

Package Overview
Dependencies
Maintainers
1
Versions
20
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@sysmanager/sys-skills - npm Package Compare versions

Comparing version
1.0.17
to
1.0.18
+1
-1
package.json
{
"name": "@sysmanager/sys-skills",
"version": "1.0.17",
"version": "1.0.18",
"description": "Agent Skills Framework - Easy setup for AI agent capabilities and integrations (Claude, Gemini, Codex, GitHub Copilot)",

@@ -5,0 +5,0 @@ "type": "module",

@@ -237,3 +237,3 @@ ---

| 5b | **ADO Board custom states configurados** | States obrigatórios existem (ver 2.3) | Delegar `ado-board-manager validate-states` |
| 5c | **MCP Outline acessível** | OAuth válido OU `OUTLINE_API_KEY` no `.env` | Delegar `outline-wiki-manager read` |
| 5c | **MCP Outline acessível** | OAuth válido (sessão mantida pelo runtime — sem variável de ambiente) | Delegar `outline-wiki-manager read` |
| 5d | **Collection da wiki existe e está registrada** | `collection_id` em Rules + `.outline-sync.json` + responde em `collections.info` | Delegar `outline-wiki-manager read` |

@@ -285,4 +285,3 @@ | 6 | **Estrutura de pastas do projeto** | `.agents/`, `specs/`, `steps/{research,plan,implement}/`, `<SKILLS_DIR>/` | `Test-Path` nos diretórios |

| Git CLI | `git-cli` | Universal | Operações git (commit, push, branch) |
| PRD Creator | `create-prd` | Research | Gerar PRD com workflow de perguntas |
| RFC Creator | `create-rfc` | Research, Plan | Propor mudanças e buscar alinhamento |
| PRD from Discovery | `prd-from-discovery` | Research, Plan | Gerar PRD e propor mudanças com workflow de perguntas e buscar alinhamento |
| ADR Creator | `create-adr` | Plan, Implement | Documentar decisões arquiteturais |

@@ -323,14 +322,7 @@ | Technical Design Doc | `create-technical-design-doc` | Plan | Criar TDD com arquitetura, contratos |

**Pré-check: detectar modo de autenticação lendo `.mcp.json`:**
**Auth mode: OAuth** — `.mcp.json` configurado sem `headers`. Nenhuma variável de ambiente necessária; sessão mantida pelo runtime Claude Code após login via `/mcp`.
```
SE bloco outline em .mcp.json contém "headers.Authorization"
→ modo API Key: verificar OUTLINE_API_KEY no .env (não-vazio, não commitado)
SENÃO
→ modo OAuth: nenhuma variável de ambiente necessária; sessão mantida pelo runtime
```
**Validação (delegada ao `outline-wiki-manager read`):**
1. Smoke `collections.list` retorna 200
2. Auth OK conforme modo detectado acima
2. OAuth válido (se 401 → `/mcp` no Claude Code para renovar sessão)
3. `collection_id` registrado em `config.yaml` existe via `collections.info`

@@ -337,0 +329,0 @@ 4. `collection_url` registrada em `config.yaml` e em `.outline-sync.json`

@@ -85,3 +85,3 @@ ---

| P4 | Pasta `specs/` criada | Para specs por épico |
| P5 | Skills de Plan instaladas | `ado-workflow`, `create-rfc`, `create-adr`, `create-technical-design-doc`, `generate-tasks`, `git-cli` no diretório do target |
| P5 | Skills de Plan instaladas | `ado-workflow`, `prd-from-discovery`, `create-adr`, `create-technical-design-doc`, `generate-tasks`, `git-cli` no diretório do target |
| P6 | Worktrees planejados | Um por épico paralelizável do `parallelism-map.md` |

@@ -88,0 +88,0 @@ | P7 | **PRD + Design Doc publicados na wiki** | URLs registrados em `.outline-sync.json` (`mappings.prd`, `mappings.design-doc`); docs existem. Delegar `outline-wiki-manager read` |

@@ -103,4 +103,3 @@ ---

│ │ ├── git-cli/SKILL.md
│ │ ├── create-prd/SKILL.md
│ │ ├── create-rfc/SKILL.md
│ │ ├── prd-from-discovery/SKILL.md
│ │ └── ado-workflow/SKILL.md

@@ -350,4 +349,3 @@ │ ├── workflows/

npx @sysmanager/sys-skills install --skill git-cli
npx @sysmanager/sys-skills install --skill create-prd
npx @sysmanager/sys-skills install --skill create-rfc
npx @sysmanager/sys-skills install --skill prd-from-discovery
```

@@ -623,3 +621,3 @@

| R6 | Template `discovery.md` disponível | Schema dos 5 blocos |
| R7 | Skills `create-prd`, `create-rfc` instaladas | Verificar diretório do target |
| R7 | Skill `prd-from-discovery` instalada | Verificar diretório do target |
| R8 | **Work items âncora no ADO** | Epic + WIT SDLC existem e estão vinculados (ver 0.5.1) |

@@ -626,0 +624,0 @@ | R9 | **Sub-collection Research preparada na wiki** | `phases.research` em `.outline-sync.json` preenchido (não-null); `parent_doc_id` e todos `steps.E0–E6.doc_id` existem. Delegar `outline-wiki-manager read` |

@@ -17,4 +17,3 @@ ---

env: []
env_optional:
OUTLINE_API_KEY: "Apenas se auth via API Key. OAuth não requer variável de ambiente."
env_optional: {}
tags: [outline, wiki, documentation, templates, sync, audit]

@@ -46,4 +45,3 @@ ---

| **Endpoint self-hosted** | `https://<seu-dominio>/mcp` |
| **Auth padrão** | OAuth (login interativo no browser) |
| **Auth alternativa** | API Key via header `Authorization: Bearer <api-key>` |
| **Auth** | OAuth (login interativo no browser via `/mcp`) |
| **Disponibilidade** | Cloud-hosted: já disponível • Self-hosted: Outline ≥ v1.6.0 |

@@ -56,13 +54,12 @@

3. **Cliente MCP que suporta HTTP transport** (Claude Code, Claude Desktop, Cursor, VS Code/Copilot recentes, Codex CLI)
4. **`OUTLINE_API_KEY` no `.env`** — **somente se** autenticando via API Key. OAuth não requer nenhuma variável de ambiente — a sessão é mantida pelo runtime do cliente MCP após o login interativo (`/mcp` no Claude Code).
### Setup do MCP por cliente
**Claude Code (CLI) — OAuth (padrão, sem API Key):**
**Claude Code (CLI) — OAuth:**
```bash
claude mcp add --transport http outline https://<subdomain>.getoutline.com/mcp
```
Dentro do Claude Code, rodar `/mcp` e seguir o fluxo OAuth (login no browser). Nenhuma variável de ambiente necessária.
Rodar `/mcp` dentro do Claude Code e seguir o fluxo OAuth (login no browser). Nenhuma variável de ambiente necessária.
Config resultante em `.mcp.json` (sem headers — OAuth gerenciado pelo runtime):
Config resultante em `.mcp.json`:
```json

@@ -79,18 +76,2 @@ {

**Claude Code (CLI) — API Key (alternativa quando OAuth não for viável):**
Acrescentar `headers` ao bloco outline em `.mcp.json` e definir `OUTLINE_API_KEY` no `.env` (não commitar):
```json
{
"mcpServers": {
"outline": {
"type": "http",
"url": "https://<subdomain>.getoutline.com/mcp",
"headers": {
"Authorization": "Bearer ${OUTLINE_API_KEY}"
}
}
}
}
```
**Claude Desktop:**

@@ -121,3 +102,2 @@ Settings → Connectors → Add Connector → URL: `https://<subdomain>.getoutline.com/mcp` → OAuth interativo.

```
Para API Key em vez de OAuth, acrescentar `"headers": { "Authorization": "Bearer ${input:outline-api-key}" }` e definir o `input`.

@@ -129,4 +109,3 @@ **Codex CLI (`~/.codex/config.toml`):**

url = "https://<subdomain>.getoutline.com/mcp"
# Auth via OAuth ao primeiro acesso. Para API Key, descomente:
# headers = { Authorization = "Bearer ${OUTLINE_API_KEY}" }
# Auth via OAuth ao primeiro acesso.
```

@@ -500,3 +479,3 @@

1. **Confirmar antes de operações destrutivas** — delete, batch delete, replace de conteúdo grande
2. **Nunca expor `OUTLINE_API_KEY`** — somente relevante no modo API Key; não logar, não printar, não inserir em commit. No modo OAuth, nenhum secret existe para expor.
2. **Nunca logar tokens OAuth** — a sessão é gerenciada pelo runtime; não reproduzir cookies ou tokens de sessão em logs ou commits.
3. **Modo read-only quando em dúvida** — se variável `OUTLINE_READ_ONLY` está setada, respeitar e bloquear writes

@@ -503,0 +482,0 @@ 4. **Sempre listar antes de batch** — mostrar lista completa de afetados ao usuário