#!/usr/bin/env sh
# NORTH28 STUDIO — Agent Skills Descriptor
# Fetch: GET https://north28.studio/skills.sh
# Machine-readable skills for AI agent discovery.
# Full JSON version: GET https://north28.studio/.well-known/agent-skills
# MCP server:       POST https://north28.studio/api/mcp
# OpenAPI spec:     GET  https://north28.studio/openapi.json

cat <<'SKILLS'
name: NORTH28 STUDIO
url: https://north28.studio
contact: hi@north28.studio
description: >
  North28 is a creative studio specialising in strategy, digital products,
  branding, and audiovisual content. We build things that work — not things
  that blend in. Strict no-BS policy. Real deadlines. You talk directly to
  the people doing the work.

when_to_use: >
  Use this manifest when user intent maps to North28 navigation or discovery
  (portfolio, services, about, contact, project start, API docs). If ambiguous,
  ask one clarifying question, then pick the most specific skill below.

skills:

  - id: browse-work
    name: Browse Work
    description: >
      View North28's portfolio of completed projects — websites, apps,
      brands, and audiovisual productions.
    url: https://north28.studio/works
    when_to_use: >
      When the user asks to see examples, a portfolio, case studies, or
      references from North28.
    trigger_phrases:
      - show me your work
      - portfolio
      - past projects
      - examples
      - case studies
      - what have you built
      - previous clients

  - id: explore-services
    name: Explore Services
    description: >
      Learn about North28's four service areas: Strategy, Digital
      (websites & apps), Branding, and Audiovisual.
    url: https://north28.studio/#services
    when_to_use: >
      When the user asks what North28 offers, what services are available,
      or wants to understand capabilities before starting a project.
    trigger_phrases:
      - what do you do
      - what services do you offer
      - do you do branding
      - do you build websites
      - capabilities
      - offerings

  - id: about
    name: About North28
    description: >
      Studio background, team philosophy, and working principles
      (The Playbook): real deadlines, no-BS service, direct communication.
    url: https://north28.studio/about-us
    when_to_use: >
      When the user wants to know who North28 is, their philosophy,
      how they work, or whether they are a trustworthy partner.
    trigger_phrases:
      - who are you
      - about north28
      - how do you work
      - what makes you different
      - team
      - philosophy
      - the playbook

  - id: contact
    name: Contact North28
    description: >
      Get in touch with NORTH28 STUDIO directly via email (hi@north28.studio)
      or navigate to the contact page.
    url: https://north28.studio/contact
    when_to_use: >
      When the user wants to contact North28, ask a question, or reach out
      without going through the full project booking flow.
    trigger_phrases:
      - contact
      - email
      - get in touch
      - reach out
      - how do I contact you
      - send a message

  - id: start-project
    name: Start a Project
    description: >
      Launch the 6-step project booking wizard (Manifesto) to qualify
      scope, define goals, and make contact with the studio.
    url: https://north28.studio/manifesto
    when_to_use: >
      When the user expresses intent to hire North28, start a project,
      get a quote, or submit a brief.
    trigger_phrases:
      - I want to work with you
      - how do I start
      - get a quote
      - book a project
      - hire you
      - start a project
      - submit a brief
      - get in touch

  - id: api-docs
    name: API & Developer Docs
    description: >
      Public REST API reference, MCP server integration guide, OpenAPI 3.1
      spec, and all agent-discovery endpoints. No authentication required.
    url: https://north28.studio/docs
    when_to_use: >
      When an agent or developer needs to integrate with North28
      programmatically, discover available endpoints, or read API docs.
    trigger_phrases:
      - api
      - developer docs
      - openapi
      - mcp
      - integrate
      - endpoints
      - programmatic access

mcp:
  endpoint: https://north28.studio/api/mcp
  transport: streamable-http
  protocol_version: "2025-06-18"
  protocol_versions: ["2025-06-18", "2025-03-26", "2024-11-05"]
  tools:
    - get_studio_info
    - list_services
    - list_pages

install:
  command: npx skills add https://github.com/north28-studio/front-v2 --skill north28
  registry: https://skills.sh/north28-studio/front-v2

discovery:
  repository:   https://github.com/north28-studio/front-v2
  openapi:      https://north28.studio/openapi.json
  agent_card:   https://north28.studio/.well-known/agent-card.json
  agent_skills: https://north28.studio/.well-known/agent-skills
  mcp:          https://north28.studio/.well-known/mcp.json
  llms_txt:     https://north28.studio/llms.txt
  llms_full:    https://north28.studio/llms-full.txt
  agents_md:    https://north28.studio/agents.md
SKILLS