Communitygithub.com

cdcoonce/Portfolio_Website

Reescreve as seções de prosa das páginas wiki diretamente. Lê os arquivos fonte para entender o contexto atual e atualiza apenas o conteúdo dentro dos marcadores <!-- claude:prose --> ... <!-- claude:prose:end -->. Nunca toca nos blocos <!-- generated:start --> ... <!-- generated:end -->. Suporta segmentar uma única página com /update-wiki {NomeDaPagina}.

O que é Portfolio_Website?

Esta skill permite que o Claude atualize dinamicamente seções de prosa escritas à mão em páginas wiki sem modificar blocos gerados automaticamente. Ela identifica marcadores HTML especiais (`<!-- claude:prose -->` e `<!-- claude:prose:end -->`), lê os arquivos fonte relevantes para construir contexto e reescreve apenas o conteúdo entre esses marcadores para refletir com precisão o estado atual do código. A skill é acionada via comandos tipo `/update-wiki` (opcionalmente com um nome de página específico) ou frases como "refresh wiki prose". Ela gerencia várias páginas, cada uma com seu propósito e conjunto de arquivos fonte, e inclui tratamento especial para o Architecture-Decision-Log, que Claude mantém inteiramente. Importante: ela protege rigorosamente os blocos `<!-- generated:start -->` … `<!-- generated:end -->` (gerados por um orquestrador) e adiciona um prompt de commit depois de terminar as atualizações.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/update-wiki

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Atualização de Wiki

Atualize as seções de prosa escritas à mão das páginas wiki para refletir o estado atual do código fonte. Blocos de métricas/dados gerados são gerenciados pelo orquestrador e nunca devem ser tocados.

Quando Invocar

  • O usuário digita /update-wiki — atualiza todas as páginas com blocos de prosa
  • O usuário digita /update-wiki Architecture — atualiza apenas wiki/Architecture.md
  • O usuário diz "atualizar prosa da wiki", "atualizar narrativa de onboarding", "reescrever documentos de arquitetura"
  • Após uma refatoração significativa que altere a narrativa do design do sistema

O Que Esta Habilidade Faz (Passo a Passo)

  1. Determinar escopo. Se um argumento com nome de página foi fornecido (ex.: Architecture), resolva para wiki/{NomeDaPagina}.md. Caso contrário, enfileire todas as páginas com prosa listadas abaixo.

  2. Para cada página alvo: a. Leia o arquivo da página wiki. b. Identifique cada bloco <!-- claude:prose --> ... <!-- claude:prose:end -->. c. Leia os arquivos fonte relevantes listados no registro de páginas abaixo para construir contexto. d. Reescreva o conteúdo entre os marcadores para que ele reflita com precisão o estado atual do código fonte — mantenha a mesma estrutura geral (cabeçalhos, ordem dos parágrafos) a menos que esteja factualmente incorreta. e. Escreva o conteúdo atualizado de volta ao arquivo, preservando exatamente os marcadores.

  3. Nunca toque nos blocos gerados. Qualquer conteúdo dentro de <!-- generated:start --> ... <!-- generated:end --> deve permanecer idêntico byte por byte. Esses blocos são mantidos pelo script orquestrador da wiki.

  4. Log de Decisões de Arquitetura é totalmente gerenciado pelo Claude. wiki/Architecture-Decision-Log.md não tem blocos generated nem marcadores claude:prose. O Claude mantém o arquivo inteiro. Ao atualizar, acrescente novas entradas de ADL para quaisquer decisões arquiteturais tomadas desde a última entrada registrada. Não modifique entradas existentes.

  5. Prompt de commit. Depois que todas as páginas forem atualizadas, lembre o usuário:

    "Prosa da wiki atualizada. Execute /commit para salvar as alterações e então fazer push para o repositório remoto da wiki."

Páginas com Prosa e Seus Arquivos Fonte

wiki/Architecture.md

Propósito do bloco de prosa: Narrativa de design do sistema — explica responsabilidades dos módulos, fluxo de dados e como o site estático + agente de chat Lambda se encaixam.

Arquivos fonte relevantes para ler:

  • WebContent/js/main.js
  • WebContent/js/filter.js
  • WebContent/js/carousel.js
  • WebContent/js/utils.js
  • lambda/lambda_function.py
  • index.html (para contexto da estrutura da página)
  • projects.html (para contexto da estrutura da página)

wiki/Lambda-Chat-Agent.md

Propósito do bloco de prosa: Fundamentação do design do agente — explica a arquitetura Lambda, carregamento da base de conhecimento, construção do prompt e tratamento de respostas.

Arquivos fonte relevantes para ler:

  • lambda/lambda_function.py
  • lambda/context/ (todos os arquivos .md, se presentes)

wiki/Contributing.md

Propósito do bloco de prosa: Narrativa de onboarding — explica o fluxo de trabalho de desenvolvimento, filosofia de teste e convenções do projeto para novos contribuidores.

Arquivos fonte relevantes para ler:

  • CLAUDE.md
  • Makefile
  • package.json
  • pyproject.toml
  • .github/workflows/ci-cd.yml

wiki/Architecture-Decision-Log.md

Tratamento especial: Sem marcadores claude:prose. O Claude é dono do arquivo inteiro. Acrescente novas entradas de ADL; nunca modifique as existentes.

Arquivos fonte relevantes para ler:

  • Revise o log recente do git para alterações arquiteturais significativas
  • CLAUDE.md para decisões atuais de ferramentas
  • lambda/lambda_function.py para decisões de backend

Regras de Preservação de Marcadores

<!-- claude:prose -->
[Claude reescreve este conteúdo]
<!-- claude:prose:end -->
<!-- generated:start -->
[NUNCA TOQUE — dados gerenciados pelo orquestrador]
<!-- generated:end -->
  • Os marcadores de abertura e fechamento devem aparecer em suas próprias linhas, inalterados.
  • Não adicione linhas em branco extras imediatamente dentro dos marcadores.
  • Não aninhe marcadores.

Aviso

NUNCA modifique blocos <!-- generated:start --> ... <!-- generated:end -->. Esses blocos contêm métricas e tabelas geradas automaticamente pelo orquestrador da wiki. Modificá-los fará com que a próxima execução do orquestrador produza um conflito de mesclagem ou sobrescreva silenciosamente suas alterações.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

Habilidades Relacionadas