AHMADJAN-New/nazim-help-center-management
.cursor/skills/nazim-help-center-management/SKILL.md
Platform admin help center CRUD for categories and articles. Use when working on Help Center Management page, categories, articles, slugs, or ordering. Uses platformApi and usePlatformAdminPermissions; no organization_id.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add AHMADJAN-New/nazim-web nazim-help-center-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 10:49 PM4.4s2 files scanned
SKILL.md
- name:
- nazim-help-center-management
- description:
- Platform admin help center CRUD for categories and articles. Use when working on Help Center Management page, categories, articles, slugs, or ordering. Uses platformApi and usePlatformAdminPermissions; no organization_id.
Nazim Help Center Management
Platform admins manage help center categories and articles via the Platform Admin app. This skill covers the CRUD UI and API patterns. For generating article content (EN→PS workflow), use nazim-help-articles.
Scope
- Platform admin only: Route
/platform/help-center; usesplatformApi,usePlatformAdminPermissions - No organization_id: Help center data is platform-wide (categories can have organization_id = null for global)
- Relationship: This skill = managing categories/articles in DB/UI. nazim-help-articles = writing markdown content for articles
Hooks
From frontend/src/platform/hooks/usePlatformAdminComplete.tsx:
- Categories:
usePlatformCreateHelpCenterCategory,usePlatformUpdateHelpCenterCategory,usePlatformDeleteHelpCenterCategory - Articles:
usePlatformCreateHelpCenterArticle,usePlatformUpdateHelpCenterArticle,usePlatformDeleteHelpCenterArticle
Categories and articles are fetched via platformApi.helpCenter.categories.list() and platformApi.helpCenter.articles.list() (query keys: platform-help-center-categories, platform-help-center-articles).
API (platformApi.helpCenter)
- Categories:
categories.list(params?),categories.get(id),categories.create(data),categories.update(id, data),categories.delete(id) - Articles:
articles.list(params?),articles.get(id),articles.create(data),articles.update(id, data),articles.delete(id),articles.publish(id),articles.unpublish(id)
All endpoints use /platform/help-center/* prefix.
Category Fields (key)
name,slug,description,icon,color,order,is_active,parent_id- Slug must be unique; used in URLs
Article Fields (key)
category_id,title,slug,excerpt,content,content_type('markdown' | 'html'),language('en' | 'ps' | 'fa' | 'ar')is_published,is_featured,is_pinned,ordermeta_title,meta_description,tags,related_article_ids,author_id
Types: frontend/src/types/api/helpCenter.ts
Page
- HelpCenterManagement.tsx — Tabs for Categories and Articles; tables with create/edit/delete; forms for category (name, slug, description, icon, color, order, is_active) and article (category, slug, title, content, language, order, is_published, etc.).
Seeding
After adding or updating articles (e.g. from markdown or API), sync to DB with:
cd backend && php artisan db:seed --class=HelpCenterArticleSeeder
Checklist
- [ ] Use
platformApi.helpCenter.*(not main app apiClient) - [ ] Use
usePlatformAdminPermissions(); redirect if nosubscription.admin - [ ] Invalidate/refetch
platform-help-center-categoriesandplatform-help-center-articlesafter mutations - [ ] Slug conventions: lowercase, hyphenated, unique per category for articles
Additional Resources
- Category/article API shape and slug conventions: reference.md
Related Skills
AHMADJAN-New/nazim-toast
tools
VerifiedTrustedCommunity
Toast notifications for Nazim. Use when showing success/error/info messages. ALWAYS use showToast from @/lib/toast with translation keys; never toast from sonner directly. RTL positioning is automatic.
SKILL.mdUpdated Apr 16, 2026
AHMADJAN-New/nazim-status-badges
tools
VerifiedTrustedCommunity
Enforces status badge patterns for Nazim UI. Use when displaying status in tables, cards, or dialogs. Covers Badge variants, semantic colors, statusBadgeVariant, statusOptions with color.
SKILL.mdUpdated Apr 16, 2026
AHMADJAN-New/nazim-responsive
development
VerifiedTrustedCommunity
Enforces mobile-first responsive patterns for Nazim UI. Use when building pages, tables, forms, charts, or buttons. Covers page container, FilterPanel, tabs, grids, tables, charts, cards, buttons.
SKILL.mdUpdated Apr 16, 2026
AHMADJAN-New/nazim-reports
development
VerifiedTrustedCommunity
PDF and Excel report generation for Nazim. Use when adding or changing reports. Backend uses ReportService and ReportConfig; frontend uses useServerReport. Covers branding, DateConversionService, RTL, acceptance criteria.
SKILL.mdUpdated Apr 16, 2026