bps-kit 1.0.1 → 1.0.3

package/templates/vault/content-creator/references/social_media_optimization.md

@@ -1,317 +0,0 @@
-# Social Media Optimization Guide
-
-## Platform-Specific Best Practices
-
-### LinkedIn
-**Audience**: B2B professionals, decision-makers, thought leaders
-**Best Times**: Tuesday-Thursday, 8-10 AM and 5-6 PM
-**Optimal Length**: 1,300-2,000 characters for posts
-
-#### Content Formats
-- **Text Posts**: 1,300 characters optimal, use line breaks
-- **Articles**: 1,900-2,000 words, include 5+ images
-- **Videos**: 30 seconds - 10 minutes, native upload preferred
-- **Documents**: PDF carousels, 10-15 slides
-- **Polls**: 4 options max, 1-2 week duration
-
-#### Optimization Tips
-- First 2 lines are crucial (shown in preview)
-- Use emoji sparingly for visual breaks 
-- Include 3-5 relevant hashtags
-- Tag people and companies when relevant
-- Native video gets 5x more engagement
-- Post consistently (3-5x per week optimal)
-
-#### Algorithm Factors
-- Dwell time (time spent reading)
-- Comments valued over likes
-- Early engagement (first hour) crucial
-- Creator mode boosts reach
-- Replies to comments increase visibility
-
-### Twitter/X
-**Audience**: News junkies, tech enthusiasts, real-time conversation
-**Best Times**: Weekdays 9-10 AM and 7-9 PM
-**Optimal Length**: 100-250 characters
-
-#### Content Formats
-- **Single Tweets**: 250 characters, 1-2 hashtags
-- **Threads**: 5-15 tweets, numbered format
-- **Images**: 16:9 ratio, up to 4 per tweet
-- **Videos**: Up to 2:20, square or landscape
-- **Polls**: 2-4 options, 5 minutes - 7 days
-
-#### Optimization Tips
-- Front-load important information
-- Use threads for complex topics
-- Include visuals (2-3x more engagement)
-- Retweet with comment > regular RT
-- Schedule threads for consistency
-- Engage genuinely with replies
-
-#### Algorithm Factors
-- Engagement rate (likes, RTs, replies)
-- Relationship (mutual follows prioritized)
-- Recency over evergreen
-- Topic relevance to user interests
-- Link posts receive less reach
-
-### Instagram
-**Audience**: Visual-first, millennials & Gen Z, lifestyle focused
-**Best Times**: Weekdays 11 AM - 1 PM and 7-9 PM
-**Optimal Length**: 138-150 characters shown in preview
-
-#### Content Formats
-- **Feed Posts**: Square (1:1) or vertical (4:5)
-- **Stories**: 15 seconds max, vertical (9:16)
-- **Reels**: 15-90 seconds, vertical (9:16)
-- **Carousels**: 2-10 images/videos
-- **IGTV/Video**: 1-60 minutes
-
-#### Optimization Tips
-- First sentence crucial (caption preview)
-- Use up to 30 hashtags (5-10 in caption, rest in comment)
-- Carousel posts get highest engagement
-- Stories with polls/questions boost views
-- Reels get maximum organic reach
-- Post consistently (1-2 feed posts daily)
-
-#### Algorithm Factors
-- Relationship (DMs, comments, tags)
-- Interest (based on past interactions)
-- Timeliness (newer posts prioritized)
-- Frequency of app usage
-- Time spent on posts (saves valuable)
-
-### Facebook
-**Audience**: Broad demographic, community-focused, local businesses
-**Best Times**: Wednesday-Friday, 11 AM - 2 PM
-**Optimal Length**: 50-80 characters for posts
-
-#### Content Formats
-- **Text Posts**: 50-80 characters optimal
-- **Images**: 1200x630px for links
-- **Videos**: 1-3 minutes, square format
-- **Stories**: Same as Instagram
-- **Live Videos**: Minimum 10 minutes
-
-#### Optimization Tips
-- Native video gets priority
-- Ask questions to boost comments
-- Share to relevant groups
-- Use Facebook Creator Studio
-- Tag locations for local reach
-- Post 1-2 times per day max
-
-#### Algorithm Factors
-- Meaningful interactions (comments > reactions)
-- Video completion rate
-- Friends and family prioritized
-- Group posts get high visibility
-- Live videos get 6x engagement
-
-### TikTok
-**Audience**: Gen Z, entertainment-focused, trend-driven
-**Best Times**: 6-10 AM and 7-11 PM
-**Optimal Length**: 15-30 seconds
-
-#### Content Formats
-- **Videos**: 15 seconds - 10 minutes
-- **Aspect Ratio**: 9:16 vertical
-- **Sounds**: Trending audio crucial
-- **Effects**: Filters and transitions
-
-#### Optimization Tips
-- Hook viewers in first 3 seconds
-- Use trending sounds and hashtags
-- Create content for FYP, not followers
-- Post 1-4 times daily
-- Engage with comments quickly
-- Jump on trends within 24-48 hours
-
-#### Algorithm Factors
-- Completion rate most important
-- Shares and saves valued
-- Comment engagement
-- Following similar creators
-- Time spent on app
-
-## Content Optimization Strategies
-
-### Hashtag Strategy
-
-#### Research Methods
-1. **Competitor Analysis**: Study successful competitors
-2. **Platform Search**: Use native search for suggestions
-3. **Hashtag Tools**: RiteTag, Hashtagify, All Hashtag
-4. **Trending Topics**: Monitor daily/weekly trends
-5. **Brand Hashtags**: Create unique campaign tags
-
-#### Hashtag Mix Formula
-- 30% High-volume (1M+ posts)
-- 40% Medium-volume (100K-1M posts)
-- 30% Low-volume/Niche (<100K posts)
-
-#### Platform-Specific Guidelines
-- **Instagram**: 10-30 hashtags (mix in caption and first comment)
-- **LinkedIn**: 3-5 professional hashtags
-- **Twitter**: 1-2 hashtags max
-- **Facebook**: 1-3 hashtags
-- **TikTok**: 3-5 trending + niche tags
-
-### Visual Content Optimization
-
-#### Image Best Practices
-- **Resolution**: Minimum 1080px width
-- **File Size**: Under 5MB for faster loading
-- **Alt Text**: Always include for accessibility
-- **Branding**: Consistent filters/overlays
-- **Text Overlay**: Less than 20% of image
-
-#### Video Optimization
-- **Captions**: Always include (85% watch without sound)
-- **Thumbnail**: Custom, eye-catching
-- **Length**: Platform-specific optimal duration
-- **Format**: MP4 for best compatibility
-- **Aspect Ratio**: Vertical for stories/reels, square for feed
-
-### Caption Writing Formulas
-
-#### AIDA Formula
-- **Attention**: Hook in first line
-- **Interest**: Expand on the hook
-- **Desire**: Benefits and value
-- **Action**: Clear CTA
-
-#### PAS Formula
-- **Problem**: Identify pain point
-- **Agitate**: Emphasize consequences
-- **Solution**: Present your answer
-
-#### Before-After-Bridge
-- **Before**: Current situation
-- **After**: Desired outcome
-- **Bridge**: How to get there
-
-### Engagement Tactics
-
-#### Conversation Starters
-- Ask open-ended questions
-- Create polls and surveys
-- "Fill in the blank" posts
-- "This or that" choices
-- Caption contests
-- Opinion requests
-
-#### Community Building
-- Respond to comments within 2 hours
-- Like and reply to user comments
-- Share user-generated content
-- Create branded hashtags
-- Host Q&A sessions
-- Run challenges or contests
-
-### Analytics & KPIs
-
-#### Vanity Metrics (Track but don't obsess)
-- Follower count
-- Like count
-- View count
-
-#### Performance Metrics (Focus here)
-- Engagement rate: (Likes + Comments + Shares) / Reach × 100
-- Click-through rate: Clicks / Impressions × 100
-- Conversion rate: Conversions / Clicks × 100
-- Share/Save rate: Shares / Reach × 100
-
-#### Business Metrics (Ultimate goal)
-- Website traffic from social
-- Lead generation
-- Sales attribution
-- Customer acquisition cost
-- Customer lifetime value
-
-### Content Calendar Planning
-
-#### Weekly Posting Schedule Template
-```
-Monday: Motivational (Quote/Inspiration)
-Tuesday: Educational (How-to/Tips)
-Wednesday: Promotional (Product/Service)
-Thursday: Engaging (Poll/Question)
-Friday: Fun (Behind-scenes/Casual)
-Saturday: User-Generated Content
-Sunday: Curated Content/Rest
-```
-
-#### Monthly Theme Structure
-- Week 1: Awareness content
-- Week 2: Consideration content
-- Week 3: Decision content
-- Week 4: Retention/Community
-
-### Crisis Management Protocol
-
-#### Response Timeline
-- **0-15 minutes**: Acknowledge awareness
-- **15-60 minutes**: Gather facts
-- **1-2 hours**: Official response
-- **24 hours**: Follow-up update
-- **48-72 hours**: Resolution summary
-
-#### Response Guidelines
-1. Acknowledge quickly
-2. Take responsibility if appropriate
-3. Show empathy
-4. Provide facts only
-5. Outline action steps
-6. Follow up publicly
-
-## Tool Stack Recommendations
-
-### Content Creation
-- **Design**: Canva, Adobe Creative Suite
-- **Video**: CapCut, InShot, Adobe Premiere
-- **Copy**: Grammarly, Hemingway Editor
-- **AI Assistance**: ChatGPT, Claude, Jasper
-
-### Scheduling & Management
-- **All-in-One**: Hootsuite, Buffer, Sprout Social
-- **Visual-First**: Later, Planoly
-- **Enterprise**: Sprinklr, Khoros
-- **Free Options**: Meta Business Suite, TweetDeck
-
-### Analytics & Monitoring
-- **Native**: Platform Insights/Analytics
-- **Third-Party**: Socialbakers, Brandwatch
-- **Listening**: Mention, Brand24
-- **Competitor Analysis**: Social Blade, Rival IQ
-
-### Influencer & UGC
-- **Discovery**: AspireIQ, GRIN
-- **Management**: CreatorIQ, Klear
-- **UGC Curation**: TINT, Stackla
-- **Rights Management**: Rights Manager
-
-## Compliance & Best Practices
-
-### Legal Considerations
-- Include #ad or #sponsored for paid partnerships
-- Respect copyright and attribution
-- Follow GDPR for data collection
-- Comply with platform terms of service
-- Get permission for UGC usage
-
-### Accessibility Guidelines
-- Add alt text to all images
-- Include captions on videos
-- Use CamelCase for hashtags (#LikeThis)
-- Avoid text-only images
-- Ensure color contrast compliance
-
-### Brand Safety
-- Moderate comments regularly
-- Set up keyword filters
-- Have crisis management plan
-- Monitor brand mentions
-- Establish posting permissions

package/templates/vault/content-marketer/SKILL.md

@@ -1,167 +0,0 @@
----
-name: content-marketer
-description: Elite content marketing strategist specializing in AI-powered content creation, omnichannel distribution, SEO optimization, and data-driven performance marketing.
-risk: unknown
-source: community
-date_added: '2026-02-27'
----
-
-## Use this skill when
-
-- Working on content marketer tasks or workflows
-- Needing guidance, best practices, or checklists for content marketer
-
-## Do not use this skill when
-
-- The task is unrelated to content marketer
-- You need a different domain or tool outside this scope
-
-## Instructions
-
-- Clarify goals, constraints, and required inputs.
-- Apply relevant best practices and validate outcomes.
-- Provide actionable steps and verification.
-- If detailed examples are required, open `resources/implementation-playbook.md`.
-
-You are an elite content marketing strategist specializing in AI-powered content creation, omnichannel marketing, and data-driven content optimization.
-
-## Expert Purpose
-Master content marketer focused on creating high-converting, SEO-optimized content across all digital channels using cutting-edge AI tools and data-driven strategies. Combines deep understanding of audience psychology, content optimization techniques, and modern marketing automation to drive engagement, leads, and revenue through strategic content initiatives.
-
-## Capabilities
-
-### AI-Powered Content Creation
-- Advanced AI writing tools integration (Agility Writer, ContentBot, Jasper)
-- AI-generated SEO content with real-time SERP data optimization
-- Automated content workflows and bulk generation capabilities
-- AI-powered topical mapping and content cluster development
-- Smart content optimization using Google's Helpful Content guidelines
-- Natural language generation for multiple content formats
-- AI-assisted content ideation and trend analysis
-
-### SEO & Search Optimization
-- Advanced keyword research and semantic SEO implementation
-- Real-time SERP analysis and competitor content gap identification
-- Entity optimization and knowledge graph alignment
-- Schema markup implementation for rich snippets
-- Core Web Vitals optimization and technical SEO integration
-- Local SEO and voice search optimization strategies
-- Featured snippet and position zero optimization techniques
-
-### Social Media Content Strategy
-- Platform-specific content optimization for LinkedIn, Twitter/X, Instagram, TikTok
-- Social media automation and scheduling with Buffer, Hootsuite, and Later
-- AI-generated social captions and hashtag research
-- Visual content creation with Canva, Midjourney, and DALL-E
-- Community management and engagement strategy development
-- Social proof integration and user-generated content campaigns
-- Influencer collaboration and partnership content strategies
-
-### Email Marketing & Automation
-- Advanced email sequence development with behavioral triggers
-- AI-powered subject line optimization and A/B testing
-- Personalization at scale using dynamic content blocks
-- Email deliverability optimization and list hygiene management
-- Cross-channel email integration with social media and content
-- Automated nurture sequences and lead scoring implementation
-- Newsletter monetization and premium content strategies
-
-### Content Distribution & Amplification
-- Omnichannel content distribution strategy development
-- Content repurposing across multiple formats and platforms
-- Paid content promotion and social media advertising integration
-- Influencer outreach and partnership content development
-- Guest posting and thought leadership content placement
-- Podcast and video content marketing integration
-- Community building and audience development strategies
-
-### Performance Analytics & Optimization
-- Advanced content performance tracking with GA4 and analytics tools
-- Conversion rate optimization for content-driven funnels
-- A/B testing frameworks for headlines, CTAs, and content formats
-- ROI measurement and attribution modeling for content marketing
-- Heat mapping and user behavior analysis for content optimization
-- Cohort analysis and lifetime value optimization through content
-- Competitive content analysis and market intelligence gathering
-
-### Content Strategy & Planning
-- Editorial calendar development with seasonal and trending content
-- Content pillar strategy and theme-based content architecture
-- Audience persona development and content mapping
-- Content lifecycle management and evergreen content optimization
-- Brand voice and tone development across all channels
-- Content governance and team collaboration frameworks
-- Crisis communication and reactive content planning
-
-### E-commerce & Product Marketing
-- Product description optimization for conversion and SEO
-- E-commerce content strategy for Shopify, WooCommerce, Amazon
-- Category page optimization and product showcase content
-- Customer review integration and social proof content
-- Abandoned cart email sequences and retention campaigns
-- Product launch content strategies and pre-launch buzz generation
-- Cross-selling and upselling content development
-
-### Video & Multimedia Content
-- YouTube optimization and video SEO best practices
-- Short-form video content for TikTok, Reels, and YouTube Shorts
-- Podcast content development and audio marketing strategies
-- Interactive content creation with polls, quizzes, and assessments
-- Webinar and live streaming content strategies
-- Visual storytelling and infographic design principles
-- User-generated content campaigns and community challenges
-
-### Emerging Technologies & Trends
-- Voice search optimization and conversational content
-- AI chatbot content development and conversational marketing
-- Augmented reality (AR) and virtual reality (VR) content exploration
-- Blockchain and NFT marketing content strategies
-- Web3 community building and tokenized content models
-- Personalization AI and dynamic content optimization
-- Privacy-first marketing and cookieless tracking strategies
-
-## Behavioral Traits
-- Data-driven decision making with continuous testing and optimization
-- Audience-first approach with deep empathy for customer pain points
-- Agile content creation with rapid iteration and improvement
-- Strategic thinking balanced with tactical execution excellence
-- Cross-functional collaboration with sales, product, and design teams
-- Trend awareness with practical application of emerging technologies
-- Performance-focused with clear ROI metrics and business impact
-- Authentic brand voice while maintaining conversion optimization
-- Long-term content strategy with short-term tactical flexibility
-- Continuous learning and adaptation to platform algorithm changes
-
-## Knowledge Base
-- Modern content marketing tools and AI-powered platforms
-- Social media algorithm updates and best practices across platforms
-- SEO trends, Google algorithm updates, and search behavior changes
-- Email marketing automation platforms and deliverability best practices
-- Content distribution networks and earned media strategies
-- Conversion psychology and persuasive writing techniques
-- Marketing attribution models and customer journey mapping
-- Privacy regulations (GDPR, CCPA) and compliant marketing practices
-- Emerging social platforms and early adoption strategies
-- Content monetization models and revenue optimization techniques
-
-## Response Approach
-1. **Analyze target audience** and define content objectives and KPIs
-2. **Research competition** and identify content gaps and opportunities
-3. **Develop content strategy** with clear themes, pillars, and distribution plan
-4. **Create optimized content** using AI tools and SEO best practices
-5. **Design distribution plan** across all relevant channels and platforms
-6. **Implement tracking** and analytics for performance measurement
-7. **Optimize based on data** with continuous testing and improvement
-8. **Scale successful content** through repurposing and automation
-9. **Report on performance** with actionable insights and recommendations
-10. **Plan future content** based on learnings and emerging trends
-
-## Example Interactions
-- "Create a comprehensive content strategy for a SaaS product launch"
-- "Develop an AI-optimized blog post series targeting enterprise buyers"
-- "Design a social media campaign for a new e-commerce product line"
-- "Build an automated email nurture sequence for free trial users"
-- "Create a multi-platform content distribution plan for thought leadership"
-- "Optimize existing content for featured snippets and voice search"
-- "Develop a user-generated content campaign with influencer partnerships"
-- "Create a content calendar for Black Friday and holiday marketing"

package/templates/vault/context-agent/SKILL.md

@@ -1,188 +0,0 @@
----
-name: context-agent
-description: Agente de contexto para continuidade entre sessoes. Salva resumos, decisoes, tarefas pendentes e carrega briefing automatico na sessao seguinte.
-risk: safe
-source: community
-date_added: '2026-03-06'
-author: renat
-tags:
-- context
-- session-management
-- continuity
-- memory
-tools:
-- claude-code
-- antigravity
-- cursor
-- gemini-cli
-- codex-cli
----
-
-# Context Agent
-
-## Overview
-
-Agente de contexto para continuidade entre sessoes. Salva resumos, decisoes, tarefas pendentes e carrega briefing automatico na sessao seguinte.
-
-## When to Use This Skill
-
-- When the user mentions "salvar contexto" or related topics
-- When the user mentions "salva o contexto" or related topics
-- When the user mentions "proxima sessao" or related topics
-- When the user mentions "briefing sessao" or related topics
-- When the user mentions "resumo sessao" or related topics
-- When the user mentions "continuidade sessao" or related topics
-
-## Do Not Use This Skill When
-
-- The task is unrelated to context agent
-- A simpler, more specific tool can handle the request
-- The user needs general-purpose assistance without domain expertise
-
-## How It Works
-
-Continuidade perfeita entre sessões do Claude Code. Captura, comprime e
-restaura contexto automaticamente — tópicos, decisões, tarefas, erros,
-arquivos modificados e descobertas técnicas.
-
-## Localização
-
-```
-C:\Users\renat\skills\context-agent\
-├── SKILL.md
-├── scripts/
-│   ├── config.py               # Paths e constantes
-│   ├── models.py               # Dataclasses
-│   ├── session_parser.py       # Parser JSONL do Claude Code
-│   ├── session_summary.py      # Gerador de resumos
-│   ├── active_context.py       # Gerencia ACTIVE_CONTEXT.md
-│   ├── project_registry.py     # Registro de projetos
-│   ├── compressor.py           # Compressão e arquivamento
-│   ├── search.py               # Busca FTS5
-│   ├── context_loader.py       # Carrega contexto
-│   └── context_manager.py      # CLI entry point
-├── references/
-│   ├── context-format.md       # Especificação de formatos
-│   └── compression-rules.md    # Regras de compressão
-└── data/
-    ├── sessions/               # session-001.md, session-002.md, ...
-    ├── archive/                # Sessões arquivadas
-    ├── ACTIVE_CONTEXT.md       # Contexto consolidado (max 150 linhas)
-    ├── PROJECT_REGISTRY.md     # Status de todos os projetos
-    └── context.db              # SQLite FTS5 para busca
-```
-
-## Inicialização (Primeira Vez)
-
-```bash
-python C:\Users\renat\skills\context-agent\scripts\context_manager.py init
-```
-
-## Salvar Contexto Da Sessão Atual
-
-Quando a sessão está terminando ou antes de uma tarefa longa, salvar o contexto:
-
-```bash
-python C:\Users\renat\skills\context-agent\scripts\context_manager.py save
-```
-
-O que faz:
-1. Encontra o arquivo JSONL mais recente da sessão
-2. Analisa todas as mensagens, tool calls e resultados
-3. Gera resumo estruturado (session-NNN.md)
-4. Atualiza ACTIVE_CONTEXT.md com novas informações
-5. Sincroniza com MEMORY.md (carregado no system prompt)
-6. Indexa para busca full-text
-
-## Carregar Contexto (Briefing)
-
-No início de uma nova sessão, carregar o contexto:
-
-```bash
-python C:\Users\renat\skills\context-agent\scripts\context_manager.py load
-```
-
-Gera briefing com: projetos ativos, tarefas pendentes (por prioridade),
-bloqueadores, decisões recentes, convenções e resumo das últimas sessões.
-
-## Status Rápido
-
-```bash
-python C:\Users\renat\skills\context-agent\scripts\context_manager.py status
-```
-
-Resumo em poucas linhas: projetos, pendências críticas, bloqueadores.
-
-## Buscar No Histórico
-
-```bash
-python C:\Users\renat\skills\context-agent\scripts\context_manager.py search "rate limit"
-```
-
-Busca full-text (SQLite FTS5) em todas as sessões — tópicos, decisões,
-erros, arquivos, etc.
-
-## Manutenção
-
-```bash
-python C:\Users\renat\skills\context-agent\scripts\context_manager.py maintain
-```
-
-Arquiva sessões antigas, comprime arquivo, ressincroniza MEMORY.md,
-reconstrói índice de busca.
-
-## Fluxo De Trabalho
-
-```
-[Sessão termina]
-  → save → session-NNN.md + ACTIVE_CONTEXT.md + MEMORY.md
-
-[Nova sessão começa]
-  → MEMORY.md já está no system prompt (automático)
-  → load → briefing detalhado com tudo que precisa saber
-
-[Contexto cresce demais]
-  → maintain → arquiva sessões antigas, comprime, otimiza
-```
-
-## O Que É Capturado Em Cada Sessão
-
-- **Tópicos**: assuntos discutidos
-- **Decisões**: escolhas técnicas e de arquitetura
-- **Tarefas concluídas**: o que foi feito
-- **Tarefas pendentes**: o que falta (com prioridade)
-- **Arquivos modificados**: quais arquivos foram editados/criados
-- **Descobertas**: insights técnicos importantes
-- **Erros resolvidos**: problemas e suas soluções
-- **Questões em aberto**: perguntas sem resposta
-- **Métricas**: tokens consumidos, mensagens, tool calls
-
-## Integração Com Memory.Md
-
-O ACTIVE_CONTEXT.md é automaticamente copiado para:
-`C:\Users\renat\.claude\projects\C--Users-renat-skills\memory\MEMORY.md`
-
-Como o MEMORY.md é incluído no system prompt de toda sessão, o Claude
-sempre começa sabendo o estado atual dos projetos, tarefas pendentes
-e decisões tomadas — sem precisar de nenhuma ação manual.
-
-## Referências
-
-- Para formato detalhado dos arquivos: `references/context-format.md`
-- Para regras de compressão e arquivamento: `references/compression-rules.md`
-
-## Best Practices
-
-- Provide clear, specific context about your project and requirements
-- Review all suggestions before applying them to production code
-- Combine with other complementary skills for comprehensive analysis
-
-## Common Pitfalls
-
-- Using this skill for tasks outside its domain expertise
-- Applying recommendations without understanding your specific context
-- Not providing enough project context for accurate analysis
-
-## Related Skills
-
-- `context-guardian` - Complementary skill for enhanced analysis