cc-codeconductor 0.2.8 → 0.2.10

package/presets/seo-hotel/commands/cc-seo-llms.md

@@ -0,0 +1,64 @@
+# SEO llms.txt Generator
+
+Generate a `llms.txt` file for AI-search readiness from a website's sitemap.
+
+## Usage
+
+```
+/cc-seo-llms --sitemap <sitemap-url> [--output <path>]
+/cc-seo-llms --url <url> [--output <path>]
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--sitemap` | One of `--url` or `--sitemap` | Remote sitemap XML URL. All URLs will be processed. |
+| `--url` | One of `--url` or `--sitemap` | Single URL to generate llms.txt entry for. |
+| `--output` | No | Output file path (default: `./llms.txt`) |
+| `--delay` | No | Delay between requests in ms (default: 500) |
+
+## Workflow
+
+1. **Fetch** the sitemap XML and extract all `<loc>` entries
+2. **Process** each URL: fetch page, extract title, description, and first paragraph
+3. **Group** entries by path segment (e.g., `/rooms/`, `/about/`, `/blog/`)
+4. **Generate** llms.txt following the specification format:
+   ```
+   # Site Name
+   > Site description
+
+   ## Section
+   - [Page Title](url): description
+   ```
+5. **Write** the output file
+
+## Hard Rules
+
+- **Sitemap-scoped only.** Only process URLs from the provided sitemap.
+- **GET only.** No POST, PUT, DELETE requests.
+- **No auth.** Never send cookies, tokens, or API keys.
+- **Timeout.** 10 seconds per request.
+- **SSRF prevention.** Reject private IP ranges and non-HTTP(S) schemes.
+- **Rate limiting.** 500ms between requests by default.
+
+## Examples
+
+```bash
+# Generate llms.txt from sitemap
+/cc-seo-llms --sitemap https://www.example.com/sitemap-0.xml
+
+# Generate for a single URL
+/cc-seo-llms --url https://www.example.com
+
+# Custom output path
+/cc-seo-llms --sitemap https://www.example.com/sitemap-0.xml --output ./public/llms.txt
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Missing required parameters |
+| 3 | Network or parsing error |

package/presets/seo-hotel/seo-hotel.yml

@@ -0,0 +1,55 @@
+name: seo-hotel
+version: 0.3.0
+description: SEO/GEO audit suite for hotel and hospitality websites
+outputContract: v1
+
+agents:
+  - id: seo-auditor
+    role: SEO Auditor
+    context: repo-readonly
+    modelHint: analytical
+    focus:
+      - technical-seo
+      - meta-tags
+      - crawlability
+      - page-speed
+
+  - id: schema-validator
+    role: Schema Validator
+    context: repo-readonly
+    modelHint: strong-reasoning
+    focus:
+      - schema-org
+      - json-ld
+      - structured-data
+      - rich-results
+
+  - id: geo-specialist
+    role: GEO Specialist
+    context: repo-readonly
+    modelHint: balanced
+    focus:
+      - ai-search
+      - citable-content
+      - llms-txt
+      - generative-engine-optimization
+
+  - id: content-strategist
+    role: Content Strategist
+    context: prompt-only
+    modelHint: balanced
+    focus:
+      - content-marketing
+      - off-page-seo
+      - backlinks
+      - hotel-copywriting
+
+  - id: astro-specialist
+    role: Astro Specialist
+    context: repo-readonly
+    modelHint: practical-coding
+    focus:
+      - astro-framework
+      - static-generation
+      - islands-architecture
+      - performance

package/presets/seo-hotel/settings.json

@@ -0,0 +1,225 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "env": {
+    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
+    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1",
+    "CLAUDE_CODE_DISABLE_AUTO_MEMORY": "1",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
+    "DISABLE_EXTRA_USAGE_COMMAND": "1",
+    "CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT": "1",
+    "ENABLE_TOOL_SEARCH": "auto",
+    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
+    "DISABLE_BUG_COMMAND": "1"
+  },
+  "includeCoAuthoredBy": false,
+  "includeGitInstructions": false,
+  "permissions": {
+    "allow": [
+      "Bash(git status*)",
+      "Bash(git diff*)",
+      "Bash(git log*)",
+      "Bash(./gradlew test*)",
+      "Bash(./gradlew build*)",
+      "Bash(./gradlew check*)",
+      "Bash(npm test*)",
+      "Bash(npm run lint*)",
+      "Bash(ls *)",
+      "Bash(cat *)",
+      "Bash(grep *)",
+      "Bash(rg *)",
+      "Bash(find *)",
+      "Bash(tree *)",
+      "Bash(echo *)",
+      "Bash(pwd)",
+      "Bash(which *)",
+      "Bash(head *)",
+      "Bash(tail *)",
+      "Bash(wc *)",
+      "Bash(diff *)",
+      "Bash(git branch*)",
+      "Bash(git show*)",
+      "Bash(git add*)",
+      "Bash(git commit*)",
+      "Bash(git stash*)",
+      "Bash(git checkout*)",
+      "Bash(git restore*)",
+      "Bash(git pull*)",
+      "Bash(git fetch*)",
+      "Bash(git merge*)",
+      "Bash(npm run *)",
+      "Bash(npm ci)",
+      "Bash(pnpm run *)",
+      "Bash(pnpm test*)",
+      "Bash(pnpm exec *)",
+      "Bash(pnpm dlx *)",
+      "Bash(yarn run *)",
+      "Bash(yarn test*)",
+      "Bash(npx *)",
+      "Bash(python *)",
+      "Bash(python3 *)",
+      "Bash(pip list*)",
+      "Bash(pip show *)",
+      "Bash(pytest*)",
+      "Bash(ruff*)",
+      "Bash(black --check *)",
+      "Bash(./gradlew *)",
+      "Bash(gradle *)",
+      "Bash(mvn test*)",
+      "Bash(mvn compile*)",
+      "Bash(java -version)",
+      "Bash(kotlin -version)",
+      "Bash(docker ps*)",
+      "Bash(docker logs*)",
+      "Bash(docker compose ps*)",
+      "Bash(docker compose logs*)",
+      "Read(**)",
+      "Write(./src/**)",
+      "Write(./app/**)",
+      "Write(./pages/**)",
+      "Write(./components/**)",
+      "Write(./lib/**)",
+      "Write(./tests/**)",
+      "Write(./test/**)",
+      "Write(./__tests__/**)",
+      "Write(./prisma/**)",
+      "Write(./drizzle/**)",
+      "Write(./public/**)",
+      "Write(./styles/**)",
+      "Write(./scripts/**)",
+      "Write(./docs/**)",
+      "Edit(**)",
+      "WebFetch(*)"
+    ],
+    "deny": [
+      "Bash(rm -rf *)",
+      "Bash(sudo *)",
+      "Bash(su *)",
+      "Bash(chmod 777 *)",
+      "Bash(chown *)",
+      "Bash(dd *)",
+      "Bash(mkfs *)",
+      "Bash(diskutil *)",
+      "Bash(mount *)",
+      "Bash(umount *)",
+      "Bash(systemctl *)",
+      "Bash(launchctl *)",
+      "Bash(curl * | sh)",
+      "Bash(curl * | bash)",
+      "Bash(wget * | sh)",
+      "Bash(wget * | bash)",
+      "Bash(git push --force*)",
+      "Bash(git push -f*)",
+      "Bash(git rebase *)",
+      "Bash(git reset --hard *)",
+      "Bash(rm -fr *)",
+      "Bash(chmod -R *)",
+      "Bash(eval *)",
+      "Bash(git push --force origin main*)",
+      "Bash(git push --force origin master*)",
+      "Bash(git push -f origin main*)",
+      "Bash(git push -f origin master*)",
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./**/.env)",
+      "Read(./**/.env.*)",
+      "Read(./secrets/**)",
+      "Read(./**/credentials.json)",
+      "Read(./**/serviceAccount*.json)",
+      "Read(./**/*.pem)",
+      "Read(./**/*.key)",
+      "Read(./**/id_rsa*)",
+      "Read(~/.ssh/**)",
+      "Read(~/.aws/**)",
+      "Read(~/.gnupg/**)",
+      "Write(./.env)",
+      "Write(./.env.*)",
+      "Write(./**/.env)",
+      "Edit(./.env)",
+      "Edit(./.env.*)",
+      "Edit(./**/.env)"
+    ],
+    "ask": [
+      "Bash(git push*)",
+      "Bash(git push --force*)",
+      "Bash(git reset --hard*)",
+      "Bash(npm install*)",
+      "Bash(npm i *)",
+      "Bash(pnpm install*)",
+      "Bash(pnpm add *)",
+      "Bash(yarn add *)",
+      "Bash(pip install*)",
+      "Bash(docker run*)",
+      "Bash(docker compose up*)",
+      "Bash(docker compose down*)",
+      "Bash(./gradlew build*)",
+      "Bash(./gradlew bootRun*)",
+      "Bash(mvn install*)",
+      "Bash(mvn deploy*)",
+      "Bash(vercel*)",
+      "Bash(npx vercel*)"
+    ],
+    "defaultMode": "acceptEdits"
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if echo \"$CLAUDE_TOOL_INPUT_FILE_PATH\" | grep -qE '\\.(ts|tsx|js|jsx|mjs|cjs|json|jsonc|md|mdx|css|scss|html|astro|yaml|yml)$'; then npx --no-install prettier --write \"$CLAUDE_TOOL_INPUT_FILE_PATH\" 2>/dev/null || true; fi"
+          },
+          {
+            "type": "command",
+            "command": "if echo \"$CLAUDE_TOOL_INPUT_FILE_PATH\" | grep -qE '\\.(ts|tsx|js|jsx|mjs|cjs)$'; then npx --no-install eslint --fix \"$CLAUDE_TOOL_INPUT_FILE_PATH\" 2>/dev/null || true; fi"
+          },
+          {
+            "type": "command",
+            "command": "if echo \"$CLAUDE_TOOL_INPUT_FILE_PATH\" | grep -qE '\\.py$'; then ruff format \"$CLAUDE_TOOL_INPUT_FILE_PATH\" 2>/dev/null && ruff check --fix \"$CLAUDE_TOOL_INPUT_FILE_PATH\" 2>/dev/null || true; fi"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if echo \"$CLAUDE_TOOL_INPUT_COMMAND\" | grep -qE '(\\.env|secrets/|id_rsa|\\.pem|\\.key)\\b' && echo \"$CLAUDE_TOOL_INPUT_COMMAND\" | grep -qE '(cat|less|more|head|tail|cp |mv |scp )'; then echo 'Bloqueado: intento de leer archivos sensibles' >&2; exit 2; fi"
+          }
+        ]
+      }
+    ]
+  },
+  "extraKnownMarketplaces": {
+    "agricidaniel-claude-seo": {
+      "source": {
+        "source": "github",
+        "repo": "AgriciDaniel/claude-seo"
+      }
+    }
+  },
+  "language": "spanish",
+  "feedbackSurveyRate": 0,
+  "spinnerTipsEnabled": false,
+  "alwaysThinkingEnabled": true,
+  "effortLevel": "xhigh",
+  "awaySummaryEnabled": false,
+  "showClearContextOnPlanAccept": true,
+  "autoUpdatesChannel": "stable",
+  "prefersReducedMotion": false,
+  "autoMemoryEnabled": false,
+  "showThinkingSummaries": true,
+  "skipDangerousModePermissionPrompt": true,
+  "editorMode": "vim",
+  "fileCheckpointingEnabled": true,
+  "showTurnDuration": true,
+  "terminalProgressBarEnabled": true,
+  "autoConnectIde": true,
+  "autoInstallIdeExtension": false,
+  "enabledPlugins": {
+    "claude-seo@agricidaniel-claude-seo": true
+  }
+}

package/presets/seo-hotel/skills/find-skills/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
+
+**Key commands:**
+
+- `npx skills find [query]` - Search for skills interactively or by keyword
+- `npx skills add <package>` - Install a skill from GitHub or other sources
+- `npx skills check` - Check for skill updates
+- `npx skills update` - Update all installed skills
+
+**Browse skills at:** https://skills.sh/
+
+## How to Help Users Find Skills
+
+### Step 1: Understand What They Need
+
+When a user asks for help with something, identify:
+
+1. The domain (e.g., React, testing, design, deployment)
+2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
+3. Whether this is a common enough task that a skill likely exists
+
+### Step 2: Check the Leaderboard First
+
+Before running a CLI search, check the [skills.sh leaderboard](https://skills.sh/) to see if a well-known skill already exists for the domain. The leaderboard ranks skills by total installs, surfacing the most popular and battle-tested options.
+
+For example, top skills for web development include:
+- `vercel-labs/agent-skills` — React, Next.js, web design (100K+ installs each)
+- `anthropics/skills` — Frontend design, document processing (100K+ installs)
+
+### Step 3: Search for Skills
+
+If the leaderboard doesn't cover the user's need, run the find command:
+
+```bash
+npx skills find [query]
+```
+
+For example:
+
+- User asks "how do I make my React app faster?" → `npx skills find react performance`
+- User asks "can you help me with PR reviews?" → `npx skills find pr review`
+- User asks "I need to create a changelog" → `npx skills find changelog`
+
+### Step 4: Verify Quality Before Recommending
+
+**Do not recommend a skill based solely on search results.** Always verify:
+
+1. **Install count** — Prefer skills with 1K+ installs. Be cautious with anything under 100.
+2. **Source reputation** — Official sources (`vercel-labs`, `anthropics`, `microsoft`) are more trustworthy than unknown authors.
+3. **GitHub stars** — Check the source repository. A skill from a repo with <100 stars should be treated with skepticism.
+
+### Step 5: Present Options to the User
+
+When you find relevant skills, present them to the user with:
+
+1. The skill name and what it does
+2. The install count and source
+3. The install command they can run
+4. A link to learn more at skills.sh
+
+Example response:
+
+```
+I found a skill that might help! The "react-best-practices" skill provides
+React and Next.js performance optimization guidelines from Vercel Engineering.
+(185K installs)
+
+To install it:
+npx skills add vercel-labs/agent-skills@react-best-practices
+
+Learn more: https://skills.sh/vercel-labs/agent-skills/react-best-practices
+```
+
+### Step 6: Offer to Install
+
+If the user wants to proceed, you can install the skill for them:
+
+```bash
+npx skills add <owner/repo@skill> -g -y
+```
+
+The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
+
+## Common Skill Categories
+
+When searching, consider these common categories:
+
+| Category        | Example Queries                          |
+| --------------- | ---------------------------------------- |
+| Web Development | react, nextjs, typescript, css, tailwind |
+| Testing         | testing, jest, playwright, e2e           |
+| DevOps          | deploy, docker, kubernetes, ci-cd        |
+| Documentation   | docs, readme, changelog, api-docs        |
+| Code Quality    | review, lint, refactor, best-practices   |
+| Design          | ui, ux, design-system, accessibility     |
+| Productivity    | workflow, automation, git                |
+
+## Tips for Effective Searches
+
+1. **Use specific keywords**: "react testing" is better than just "testing"
+2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
+3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
+
+## When No Skills Are Found
+
+If no relevant skills exist:
+
+1. Acknowledge that no existing skill was found
+2. Offer to help with the task directly using your general capabilities
+3. Suggest the user could create their own skill with `npx skills init`
+
+Example:
+
+```
+I searched for skills related to "xyz" but didn't find any matches.
+I can still help you with this task directly! Would you like me to proceed?
+
+If this is something you do often, you could create your own skill:
+npx skills init my-xyz-skill
+```