manage-ccv-projects

Definição da responsabilidade principal do IM do cc-viewer: ajudar o usuário a gerenciar os projetos ccv deste servidor. Seja quando o usuário pergunta «o que você consegue fazer / em que pode me ajudar», seja «liste / quais projetos existem», «quais ccv já foram iniciados», «quais projetos estão rodando», «inicie / abra / suba o projeto X», «me dê um endereço que abra no celular / na rede local», ou até apenas um simples «oi / olá / e aí / hi / hello» sem nenhum pedido concreto, você deve usar esta habilidade (diante de um simples cumprimento, apresente-se por conta própria e diga ao usuário o que você sabe fazer). Assim que uma mensagem envolver consultar, iniciar ou o endereço de acesso de um projeto ccv, ou for apenas uma cordialidade de cumprimento, passe por aqui com prioridade — é o trabalho próprio do IM, não o contorne para improvisar por conta própria.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable instruction skill with executable commands and clear success/failure handling. Main weaknesses are minor verbosity in the conversational prose and a referenced script that is absent from the bundle, leaving its progressive-disclosure reference unverified.

Suggestions

Add the bundled `scripts/ccv-projects.mjs` to the skill bundle (or confirm its path) so the body's repeated script references resolve to a real file.

Trim the repeated greeting/empty-list coaching in Capacidade 3 and Capacidade 1 to a single concise instruction to reduce token weight.

Document the `probe` subcommand (listed in the signature) in its own short step or remove it from the usage line to keep the workflow complete.

Dimension	Reasoning	Score
Conciseness	The body is largely efficient and assumes Claude's competence (executable commands, no concept explanation), but the conversational Portuguese prose and repeated guidance around greetings/empty-list prompts add some padding that could be trimmed.	4 / 5
Actionability	Fully executable guidance throughout: concrete `node scripts/ccv-projects.mjs <list\|probe\|start> [dir]` commands per capability, an explicit success-line example URL with token, and concrete failure-handling cases (directory missing, ccv not installed).	5 / 5
Workflow Clarity	The start workflow has a clear sequence with an implicit checkpoint (script returns one-line address on success, non-zero exit on failure) plus error-recovery guidance, but there is no explicit validate-then-retry feedback loop and the `probe` subcommand is listed in the signature yet never explained in a workflow step.	4 / 5
Progressive Disclosure	Well-organized sections (script associado, three capabilities, style/limits) with mechanical logic intentionally delegated to the bundled script; however the referenced `scripts/ccv-projects.mjs` is not present in the bundle, so the one-level-deep reference cannot be verified as a real file.	4 / 5
	Total	17 / 20 Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, trigger-rich description that clearly states what the skill does and when to use it, with excellent natural-language keyword coverage in Portuguese. It would benefit from slightly tighter, more enumeration-style phrasing and a narrower greeting clause to reduce overlap risk.

Suggestions

Tighten the capability list into a compact enumeration (e.g. 'lista projetos iniciados, inicia um projeto a partir de um diretório, devolve o endereço de acesso na rede local') so each concrete action is visible at a glance.

Narrow the greeting/cordiality clause or scope it explicitly to this server's ccv context to lower overlap risk with a general assistant skill.

Reconsider the second-person/imperative voice ('você deve usar esta habilidade') — third-person declarative ('Usa-se esta habilidade quando...') aligns better with the rubric's voice guideline.

Dimension	Reasoning	Score
Specificity	Names the domain (gerenciar projetos ccv) and several concrete actions — listar projetos, iniciar/subir um projeto, entregar endereço de acesso, responder a cumprimentos — but the phrasing leans slightly conversational rather than crisply enumerating each capability, leaving minor coverage gaps.	4 / 5
Completeness	Explicitly answers both 'what' (ajudar o usuário a gerenciar os projetos ccv deste servidor) and 'when' (Assim que uma mensagem envolver consultar, iniciar ou o endereço... ou for apenas uma cordialidade de cumprimento, passe por aqui com prioridade) with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage in Portuguese including synonyms and greeting variants: «liste / quais projetos existem», «quais ccv já foram iniciados», «inicie / abra / suba o projeto X», «me dê um endereço que abra no celular», «oi / olá / e aí / hi / hello».	5 / 5
Distinctiveness Conflict Risk	It carves a clear niche (ccv project management on this server) with distinct triggers, but the greeting/cordiality clause broadens it enough to risk minor overlap with general assistant skills.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 3 missing	Warning

	Total	15 / 16 Passed

Repository: weiesky/cc-viewer
Path: server/imSkills/pt-BR/manage-ccv-projects/SKILL.md
Commit: 817dc87

Reviewed: 9 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.