solution-architecture

iurFriend Skill Development — Marketing-Ecosystem Skill Factory

This repository (skill-development) is the skill factory for iurFriend: the centralized environment where all Claude Code plugins are developed, tested, and refined. It is structured as a plugin marketplace (iurfriend-skills), but the primary activity is building and refining skills, not distributing them. Forward-going, marketplace-distributable skills ship as plugins (single- or multi-skill) per Anthropic's canonical shape.

First stop for anyone (AI or human) doing skill work — read these three before touching anything:

• CLAUDE.md — the de-facto orientation doc: the full plugin catalog, plugin architecture, credential/contract/orchestrator doctrine, and the development workflow.
• PATTERNS.md — Layer-0 canonical index of every binding doctrine, principle, R-decision, and shared contract (routes to the sources in .agents/ and concepts/skills-ecosystem/).
• AGENTS.md — the Codex / Opencode parity entry-point; mirrors CLAUDE.md's catastrophic-invariant summary for non-Claude harnesses.

The README below is the marketplace-facing front door. The canonical rules live in the three files above — this README orients, it does not govern.

What this repo produces

25 marketplace plugins (plus the resident iurfriend-skill-patterns carrier, counted separately) across the marketing operating system and supporting web/management/observability tooling — brand extraction, funnel and conversion design, SEO, content creation, concept development, measurement and optimisation, site building/design/review/refactor, solution architecture, team and finance operations, data-collection engineering, creative media and podcast generation, voice, and LLM observability operators (LangFuse, MLflow).

Plus a vendored (third-party) tier — 18 vetted-external developer-tooling and productivity plugins imported for iurFriend employees (superpowers, beads, cloudflare, n8n-skills, supabase, obsidian-skills, defuddle, impeccable, extract-design, agent-browser, using-entire, frontmatter-generation, asana, and the official agent-sdk-dev / claude-code-setup / claude-md-management / feature-dev / mcp-server-dev). These are not factory-built: each is copied verbatim from a permissively-licensed upstream (MIT/Apache-2.0, or license flagged UNCONFIRMED), carries its LICENSE + UPSTREAM.md, and is listed in the auditable VENDORED.md register. The Anthropic docx/xlsx/pdf/pptx document skills are proprietary and not vendored; they are approved for install directly on iurFriend laptops — see EXTERNAL-PLUGINS.md (the companion register to VENDORED.md) for the exact install commands. Full vendored per-plugin catalog: the Vendored plugins section in CLAUDE.md.

For the authoritative, per-plugin catalog with one-line purposes, see the Plugins in This Marketplace table in CLAUDE.md. It is kept current; this README does not duplicate it.

Directory map

Every top-level entry, one line each. Plugin directories are listed collectively (each is a self-contained plugin — see the canonical layout in CLAUDE.md § Plugin Architecture); the per-plugin catalog is in CLAUDE.md.